Brand Intelligence

Auto-complete Brand

Changed on

Find up to 10 brands by name or domain, ordered by popularity. Optionally filter by country and primary language; both filters must match when provided together. Results include description, country, and language when available. Use the returned domain to retrieve a full brand profile.

get/brand/search

Request

  • Base URL: https://api.context.dev/v1
  • URL: https://api.context.dev/v1/brand/search
  • Auth: HTTP bearer

Query parameters

querystring required

Search term, matched against the fields selected by queryBy (e.g. 'stripe', 'stripe.com', 'stri').

country'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW'

Only return brands in this country, as an uppercase ISO 3166-1 alpha-2 code such as US or GB.

Example:US
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'

Only return brands with this primary language, such as english or french.

autocompleteboolean

Whether the search term matches by prefix, so partial words match as they are typed (e.g. 'stri' matches Stripe). Set to false to match whole words only.

queryBystring[]

Fields to match the search term against, as a comma-separated list or repeated parameter: 'name', 'domain', or both. Defaults to both.

typoToleranceinteger

Maximum number of typos tolerated when matching, from 0 to 2. Defaults to 0 (no typo tolerance).

tagsstring[]

Labels for filtering usage in the dashboard.

Comma-separated labels for filtering usage, e.g. production,team-alpha.

[
  "production",
  "team-alpha"
]

Response

Successful response

request_idstring uuid required

Unique ID of this request, also in X-Request-Id. Include it when contacting support.

Example response

{
  "results": [
    {
      "domain": "stripe.com",
      "name": "Stripe",
      "description": "Stripe designs athletic footwear and apparel.",
      "country": "US",
      "language": "english",
      "logo": "https://logos.context.dev/?publicClientId=brandLL_1a2b3c&domain=stripe.com"
    }
  ],
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"
}

Changes

  • 61627728926bRevision changes
    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

  • 4ddcf49b9fe5Revision changes
    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status