Skip to main content
Send up to 100 identifiers in one request. Get one result per identifier, in the order you sent them.
Batch lookup
Each result carries the identifier you sent, a status and, on a 200, the brand (shortened here):
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, on its own or in your next batch. A string is read as the identifier of GET /v2/brands/{identifier}: a domain, website URL, email address, brand ID, ticker or ISIN. To name the type, send an object: { "type": "ticker", "value": "BHP.AX" }. type is domain, ticker, isin, crypto or brandId. An exchange-suffixed ticker sent as a string, such as bhp.ax, is read as a domain. cachedOnly, allowNsfw and palette go in the body, as booleans, and mean what they mean on GET. 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. When your organization has fewer credits left than a batch could use, the batch is refused with 429 and nothing is charged. Batch lookups are available on paid plans and with prepaid credits. A free plan receives 403 with the header x-bf-error: paid_plan_required. See the reference for the full contract.