Pagination and filters

List endpoints return a page at a time and are narrowed with query parameters.

Cursor pagination

A list response has three fields next to data: has_more, next_cursor and, when you asked for it with include=total, total. Pass next_cursor as cursor to get the next page. A cursor is opaque and short-lived: do not build or store one.

{
  "data": [ … ],
  "has_more": true,
  "next_cursor": "eyJvIjoyNX0"
}

curl "https://api.retailbrands.global/v1/brands?limit=50&cursor=eyJvIjoyNX0" \
  -H "Authorization: Bearer $RB_API_KEY"

limit is 1 to 100 and defaults to 25.

Filters

Filters narrow the list and combine with and. A filter that accepts several values takes them repeated or comma-separated (country=GB,FR). Dates are ISO 8601; since on signals returns only what was published after a date.

Expanding and selecting

Add fields=id,name,score.rbsi to get only the fields you need, and include=group on a list to embed a related object instead of its id.