Skip to main content
POST
Get up to 100 brands in one request
Send up to 100 identifiers. Get one result per identifier, in the order you sent them, each answered the way GET /v2/brands/{identifier} answers it.A batch never crawls while you wait. A brand that is not indexed yet is queued for indexing and answered 202. Request it again later.Each identifier answered 200 uses one API credit. Every other result is free, 404 included, and an identifier repeated in one request is charged once. Available on paid plans and with prepaid credits. See Batch lookups.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
identifiers
(string | object)[]
required

The brands to look up. A string is read as the identifier of GET /v2/brands/{identifier}: a domain, website URL, email address, brand ID, ticker or ISIN. An object names the identifier's type, as GET /v2/brands/{type}/{identifier} does. An exchange-suffixed ticker sent as a string, such as bhp.ax, is read as a domain: send it as { "type": "ticker", "value": "BHP.AX" }.

Required array length: 1 - 100 elements
Required string length: 1 - 2048
Example:

"nike.com"

Example:
cachedOnly
boolean
default:false

Answer from the index alone. A brand that is not indexed is answered 204 and is not queued, and a ticker, ISIN or crypto symbol that is not indexed is not resolved. A 204 is free.

allowNsfw
boolean

As allowNsfw on GET /v2/brands/{identifier}. Not set by default.

palette
boolean
default:false

As palette on GET /v2/brands/{identifier}: add each brand's palette.

Response

One result per identifier, in the order you sent them.

results
object[]