Skip to main content
POST
Search brands and creators

Authorizations

Authorization
string
header
required

An API key from Settings → API, prefixed sg_live_.

Body

application/json
mode
enum<string>
required
Available options:
ids,
brand_name,
smart
brandIds
(string | number)[]
Maximum array length: 100

Spyglass brand id, either a uuid or a numeric platform id. May be given as a string or a number.

Maximum string length: 200
brandNames
string[]
Maximum array length: 100
Required string length: 3 - 200
query
string
Maximum string length: 500
type
enum<string>
Available options:
BRAND,
CREATOR
count
integer
Required range: 1 <= x <= 100
minFollowers
integer
Required range: 0 <= x <= 2147483647
maxFollowers
integer
Required range: 0 <= x <= 2147483647
sortBy
enum<string>
Available options:
NAME,
MOST_FOLLOWERS,
LEAST_FOLLOWERS,
MOST_VIEWS,
HIGHEST_ENGAGEMENT,
MOST_ACTIVE_ADS
ethnicity
enum<string>
Available options:
White,
Black,
Asian,
Hispanic,
Middle Eastern,
Indigenous,
Pacific Islander
gender
enum<string>
Available options:
male,
female,
other
ageRange
enum<string>
Available options:
0-18,
18-24,
25-34,
35-44,
45-54,
55-64,
65+
location
string
language
enum<string>
Available options:
English,
Spanish,
French,
German,
Italian,
Portuguese,
Russian,
Chinese,
Cantonese,
Japanese,
Korean,
Arabic,
Hindi,
Dutch,
Polish,
Turkish,
Vietnamese,
Thai,
Burmese,
Khmer,
Lao,
Indonesian,
Hebrew,
Swedish,
Norwegian,
Danish,
Finnish,
Farsi,
Fijian,
Greek,
Czech,
Hungarian,
Romanian,
Ukrainian,
Malay,
Tagalog,
Filipino,
Bengali,
Serbian,
Croatian,
Bulgarian,
Slovak,
Slovenian,
Estonian,
Latvian,
Lithuanian,
Persian,
Swahili,
Amharic,
Assamese,
Urdu,
Afrikaans,
Basque,
Catalan,
Icelandic,
Georgian,
Albanian,
Armenian,
Azerbaijani,
Bosnian,
Galician,
Gujarati,
Haitian Creole,
Kannada,
Kazakh,
Kyrgyz,
Latin,
Macedonian,
Malayalam,
Marathi,
Mizo,
Montenegrin,
Nepali,
Sinhala,
Tamil,
Telugu,
Tulu,
Punjabi,
Welsh,
Irish,
Maltese,
Yoruba,
Zulu,
ASL,
Asturian,
Bambara,
Belarusian,
Bhojpuri,
Bisaya,
Bodo,
Cebuano,
Chechen,
Cherokee,
Chichewa,
Coptic,
Cornish,
Dari,
Dhivehi,
Esperanto,
Ewe,
Faroese,
Frisian,
Guarani,
Hausa,
Hawaiian,
Hiligaynon,
Hmong,
Igbo,
Ilocano,
Jamaican Patois,
Javanese,
Kashmiri,
Kikuyu,
Kinyarwanda,
Konkani,
Kurdish,
Lingala,
Luxembourgish,
Luganda,
Malagasy,
Manipuri,
Maori,
Mongolian,
Nigerian Pidgin,
Nyanja,
Odia,
Oromo,
Papiamento,
Pashto,
Quechua,
Samoan,
Sanskrit,
Scottish Gaelic,
Sepedi,
Shona,
Sindhi,
Somali,
Sotho,
Sundanese,
Tajik,
Tamazight,
Tetum,
Tibetan,
Tongan,
Tsonga,
Tswana,
Twi,
Uzbek,
Wolof,
Xhosa,
Khasi

Response

Matching brands.

count
integer
required
brands
object[]
required
unmatchedIds
string[]