This endpoint has two mutually exclusive modes, selected by which
query parameters are present. Mixing them is a 400, as is any query
parameter not valid for the selected mode.
Identifier/URL lookup — exactly one of gtin or url, plus
optional retailer and region. Returns a single Product. At MVP,
gtin and url are the only supported lookup identifiers.
Category search — category, plus optional limit and cursor.
retailer and region are not accepted in this mode. Returns a
paginated CategorySearchResponse.
Results are filtered to the retailers your organization is entitled
to; disallowed items are silently omitted from the page rather than
causing an error, so meta.count can be smaller than limit even
when more results exist. Use meta.next_cursor (not meta.count) to
decide whether to keep paging: it is "" once there are no more
results. The cursor is opaque — treat it as an unparsed token from the
previous response, not something to construct yourself.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||