Search brands and creators
Resolve brands by id, by name, or by a natural-language query. Exactly one shape is valid per mode, and these rules are enforced by the API but cannot be expressed in JSON Schema, so a generated client will not catch them for you:
mode: "ids"requiresbrandIds.mode: "brand_name"requiresbrandNamesandtype.mode: "smart"requiresqueryandtype, and rejectssortBybecause results are ordered by relevance.
count (default 10, max 100) bounds how many rows brand_name
and smart return, and therefore what the call costs. It is
ignored for mode: "ids", which returns one row per id supplied.
Limited to 60 requests per minute for this endpoint.
Costs 2,500 microdollars ($0.0025) per brand returned, charged against your plan’s monthly credits. The count field is what you were charged for.
With mode: "smart" the call runs a language model, so it bills a
minimum of one row even when nothing matches.
Authorizations
An API key from Settings → API, prefixed sg_live_.
Body
ids, brand_name, smart 100Spyglass brand id, either a uuid or a numeric platform id. May be given as a string or a number.
1003 - 200500BRAND, CREATOR 1 <= x <= 100x >= 0x >= 0NAME, MOST_FOLLOWERS, LEAST_FOLLOWERS, MOST_VIEWS, HIGHEST_ENGAGEMENT, MOST_ACTIVE_ADS