Skip to main content
GET
How much evidence stands behind ids, and what was looked at

Query Parameters

id
string[]
required

An id from resolve. Repeat the parameter for a batch (id=a&id=b), at most 25; ids=a,b is refused.

Pattern: ^(spt|gpc|brand|retailer):.+$
retailer
string

Narrows a brand's coverage to one chain: seen there, scanned and not seen, or not scanned. Needs at least one brand id.

Pattern: ^retailer:[a-z0-9]{1,64}$
country
enum<string>
default:us

Coverage is per country, so a typo is a 400 rather than a quiet read of the other one.

Available options:
us,
ca

Response

The answer, naming the vocabulary release it came from

results
object[]
required

One per id=, in the order sent.

country
enum<string>
required
Available options:
us,
ca
vocab
object
required

The vocabulary release that answered, so an answer can be tied to the taxonomy, product-type map and aliases it was built from. The first three are also the X-Taxonomy-Release, X-GPC-Release and X-Map-Version response headers.

schema_version
string
required
Example:

"ontology/1"