Brand Intelligence

Retrieve brand data by stock ticker

Retrieve brand information using a stock ticker symbol.

get/brand/retrieve-by-ticker

Query parameters

tickerstring required

Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A'). Must be 1-15 characters, letters/numbers/dots only.

ticker_exchange'AMEX' | 'AMS' | 'AQS' | 'ASX' | 'ATH' | 'BER' | 'BME' | 'BRU' | 'BSE' | 'BUD' | 'BUE' | 'BVC' | 'CBOE' | 'CNQ' | 'CPH' | 'DFM' | 'DOH' | 'DUB' | 'DUS' | 'DXE' | 'EGX' | 'FSX' | 'HAM' | 'HEL' | 'HKSE' | 'HOSE' | 'ICE' | 'IOB' | 'IST' | 'JKT' | 'JNB' | 'JPX' | 'KLS' | 'KOE' | 'KSC' | 'KUW' | 'LIS' | 'LSE' | 'MCX' | 'MEX' | 'MIL' | 'MUN' | 'NASDAQ' | 'NEO' | 'NSE' | 'NYSE' | 'NZE' | 'OSL' | 'OTC' | 'PAR' | 'PNK' | 'PRA' | 'RIS' | 'SAO' | 'SAU' | 'SES' | 'SET' | 'SGO' | 'SHH' | 'SHZ' | 'SIX' | 'STO' | 'STU' | 'TAI' | 'TAL' | 'TLV' | 'TSX' | 'TSXV' | 'TWO' | 'VIE' | 'WSE' | 'XETRA'

Optional stock exchange for the ticker. Defaults to NASDAQ if not specified.

force_language'afrikaans' | 'albanian' | 'amharic' | 'arabic' | 'armenian' | 'assamese' | 'aymara' | 'azeri' | 'basque' | 'belarusian' | 'bengali' | 'bosnian' | 'bulgarian' | 'burmese' | 'cantonese' | 'catalan' | 'cebuano' | 'chinese' | 'corsican' | 'croatian' | 'czech' | 'danish' | 'dutch' | 'english' | 'esperanto' | 'estonian' | 'farsi' | 'fijian' | 'finnish' | 'french' | 'galician' | 'georgian' | 'german' | 'greek' | 'guarani' | 'gujarati' | 'haitian-creole' | 'hausa' | 'hawaiian' | 'hebrew' | 'hindi' | 'hmong' | 'hungarian' | 'icelandic' | 'igbo' | 'indonesian' | 'irish' | 'italian' | 'japanese' | 'javanese' | 'kannada' | 'kazakh' | 'khmer' | 'kinyarwanda' | 'korean' | 'kurdish' | 'kyrgyz' | 'lao' | 'latin' | 'latvian' | 'lingala' | 'lithuanian' | 'luxembourgish' | 'macedonian' | 'malagasy' | 'malay' | 'malayalam' | 'maltese' | 'maori' | 'marathi' | 'mongolian' | 'nepali' | 'norwegian' | 'odia' | 'oromo' | 'pashto' | 'pidgin' | 'polish' | 'portuguese' | 'punjabi' | 'quechua' | 'romanian' | 'russian' | 'samoan' | 'scottish-gaelic' | 'serbian' | 'sesotho' | 'shona' | 'sindhi' | 'sinhala' | 'slovak' | 'slovene' | 'somali' | 'spanish' | 'sundanese' | 'swahili' | 'swedish' | 'tagalog' | 'tajik' | 'tamil' | 'tatar' | 'telugu' | 'thai' | 'tibetan' | 'tigrinya' | 'tongan' | 'tswana' | 'turkish' | 'turkmen' | 'ukrainian' | 'urdu' | 'uyghur' | 'uzbek' | 'vietnamese' | 'welsh' | 'wolof' | 'xhosa' | 'yiddish' | 'yoruba' | 'zulu'

Optional parameter to force the language of the retrieved brand data.

maxSpeedboolean

Optional parameter to optimize the API call for maximum speed. When set to true, the API will skip time-consuming operations for faster response at the cost of less comprehensive data.

maxAgeMsinteger

Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms) are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1 year.

timeoutMSinteger

Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).

Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).

Response

Successful response

statusstring

Status of the response, e.g., 'ok'

codeinteger

HTTP status code

Changes