{
"message": "Not enough API credits remain for this batch.",
"quota": 123,
"used": 123,
"remaining": 123,
"required": 123
}
Brand API batch
Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way GET /v2/brands/{identifier} answers it.
One difference: 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.
Each identifier answered 200 uses one API credit. Every other result is free, 404 included. An identifier repeated in one request is charged once.
Available on paid plans and with prepaid credits. Authenticate with an API key sent as Authorization: Bearer <key>.
{
"message": "Not enough API credits remain for this batch.",
"quota": 123,
"used": 123,
"remaining": 123,
"required": 123
}
Send up to 100 identifiers. Get one result per identifier, in the order you
sent them, each answered the way GET /v2/brands/{identifier} answers it.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.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. Available on paid plans and with prepaid credits. See
Batch lookups.
The brands to look up. A string is read as the identifier of GET /v2/brands/{identifier}: a domain, website URL, email address, brand ID, ticker or ISIN. An object names the identifier's type, as GET /v2/brands/{type}/{identifier} does. An exchange-suffixed ticker sent as a string, such as bhp.ax, is read as a domain: send it as { "type": "ticker", "value": "BHP.AX" }.
Answer from the index alone. A brand that is not indexed is answered 204 and is not queued, and a ticker, ISIN or crypto symbol that is not indexed is not resolved. A 204 is free.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Brandfetch","colors":{"primary":"#0084FF","light":"#FFFFFF","dark":"#0084FF"},"logo":{"light":"https://mintcdn.com/brandfetch-d7fb5329/-v6e41qD3Fxu16r-/logo/light.svg?fit=max\u0026auto=format\u0026n=-v6e41qD3Fxu16r-\u0026q=85\u0026s=4f8ea49e20e0d743c9a7754b14f01924","dark":"https://mintcdn.com/brandfetch-d7fb5329/-v6e41qD3Fxu16r-/logo/dark.svg?fit=max\u0026auto=format\u0026n=-v6e41qD3Fxu16r-\u0026q=85\u0026s=a447e4997a5b774c621a6b318290592f"},"favicon":"https://mintcdn.com/brandfetch-d7fb5329/XKUNPCS3k4Mv8APc/favicon.svg?fit=max\u0026auto=format\u0026n=XKUNPCS3k4Mv8APc\u0026q=85\u0026s=265eef38a8f076aea2e159f8e89605f9","api":{"openapi":"openapi.json"},"appearance":{"default":"dark"},"background":{"color":{"light":"#FAFAFA","dark":"#08090A"}},"navbar":{"links":[{"href":"https://brandfetch.com/developers/pricing","label":"Pricing"},{"href":"https://brandfetch.com/developers/contact/sales","label":"Contact sales"}],"primary":{"type":"button","label":"Dashboard","href":"https://developers.brandfetch.com"}},"footer":{"socials":{"x":"https://x.com/brandfetch","linkedin":"https://linkedin.com/company/brandfetch","instagram":"https://instagram.com/brandfetch"}},"seo":{"metatags":{"og:image":"https://developers.brandfetch.com/og_docs.webp"},"indexing":"navigable"},"fonts":{"heading":{"family":"Poppins"},"body":{"family":"Inter"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"gtm":{"tagId":"GTM-MMMXMV7"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"brandfetch-d7fb5329","hasAudioNarration":false,"actualSubdomain":"brandfetch-d7fb5329","customDomains":["docs.brandfetch.com"],"gitSource":{"type":"github","owner":"brandfetch","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adf2a8ad7cf896c8ad7df12","collectionId":"65cac424-6df6-44e0-a8b3-757d4324eea7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adf2a8ad7cf896c8ad7df12"},"feedback":{"thumbs":true,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adf2a8ad7cf896c8ad7df12","clientVersion":"0.0.4005","searchFilterCounts":[{"language":"default","tag":"Documentation","count":27},{"language":"default","tag":"API References","count":14},{"language":"default","tag":"Resources","count":12},{"language":"default","tag":"Use cases","count":10},{"language":"default","tag":"Delivery methods","count":8},{"language":"default","tag":"Brand API","count":8},{"language":"default","tag":"Products","count":7},{"language":"default","tag":"Support","count":6},{"language":"default","tag":"Comparisons","count":5},{"language":"default","tag":"Webhooks","count":5}]},"assistantConfig":{"deflection":{"enabled":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"body::before{content:\"\";position:absolute;top:-192px;left:50%;z-index:-1;width:calc(100% + 128px);height:528px;background:linear-gradient(92deg,#369eff 0,#75bcff 14%,#9747ff 26%,#ef4c77 34%,#ff7510 48%,#ffda00 56%,#ffda00 72%,#76cc4b 88%,#375d96 96%,#1c4686 100%);filter:blur(100px);opacity:.075;transform:translateX(-50%);pointer-events:none}.dark body::before{background:linear-gradient(-90deg,#000 -9.95%,#1ed2ed -1.71%,#92caff 16.58%,#503957 43.26%,#ed4aff 73.47%,#ff5836 111.54%,#1c4686 130.11%);opacity:.25}body{overflow-x:clip}#sidebar .sticky.top-0.pointer-events-none{background:0 0!important;backdrop-filter:blur(4px);-webkit-backdrop-filter:blur(4px);mask-image:linear-gradient(to bottom,#000,transparent);-webkit-mask-image:linear-gradient(to bottom,#000,transparent)}html.dark{--gray-100:248 248 248;--gray-200:236 236 236;--gray-300:222 222 222;--gray-400:184 184 184;--gray-500:140 140 140;--gray-600:104 104 104}.dark #navbar a.dark\\:text-gray-400,.dark .nav-tabs-item:not([data-active=true]){color:rgba(255,255,255,.72)!important}.dark #navbar a.dark\\:text-gray-400:hover,.dark .nav-tabs-item:not([data-active=true]):hover{color:#fff!important}.dark .nav-tabs-item[data-active=true]{color:#fff!important}.dark .nav-tabs-item:not([data-active=true]):hover>.absolute.bottom-0{background-color:rgba(255,255,255,.45)!important}.card{background-color:#f7f7f8!important}.dark .card{background-color:#1a1a1a60!important}.prompt{background-color:#f4f4f5!important;border-color:#e4e4e7!important}.dark .prompt{background-color:#1d1e20!important;border-color:rgba(255,255,255,.08)!important}@media (min-width:1024px){#sidebar{width:19rem;min-width:19rem}#content-side-layout{max-width:25rem}#content-side-layout>div{width:25rem}#table-of-contents-layout{max-width:20rem}#table-of-contents-layout>div{width:20rem}}"}],"page":{"pagePath":"reference/brand-api-batch","slug":"/reference/brand-api-batch","pageMetadata":{"title":"Brand API batch","sidebarTitle":"/v2/brands/batch","openapi":"POST /v2/brands/batch","description":"Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way `GET /v2/brands/{identifier}` answers it.\n\nOne difference: 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.\n\nEach identifier answered `200` uses one API credit. Every other result is free, `404` included. An identifier repeated in one request is charged once.\n\nAvailable on paid plans and with prepaid credits. Authenticate with an API key sent as `Authorization: Bearer \u003ckey>`.","href":"/reference/brand-api-batch"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way \", _jsx(_components.code, {\n children: \"GET /v2/brands/{identifier}\"\n }), \" answers it.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"One difference: a batch never crawls while you wait. A brand that is not indexed yet is queued for indexing and answered \", _jsx(_components.code, {\n children: \"202\"\n }), \". Request it again later.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Each identifier answered \", _jsx(_components.code, {\n children: \"200\"\n }), \" uses one API credit. Every other result is free, \", _jsx(_components.code, {\n children: \"404\"\n }), \" included. An identifier repeated in one request is charged once.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Available on paid plans and with prepaid credits. Authenticate with an API key sent as \", _jsx(_components.code, {\n children: \"Authorization: Bearer \u003ckey>\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(Note,{children:[_jsxs(_components.p,{children:[`Send up to 100 identifiers. Get one result per identifier, in the order you\nsent them, each answered the way `,_jsx(_components.code,{children:`GET /v2/brands/{identifier}`}),` answers it.`]}),_jsxs(_components.p,{children:[`A batch never crawls while you wait. A brand that is not indexed yet is\nqueued for indexing and answered `,_jsx(_components.code,{children:`202`}),`. Request it again later.`]}),_jsxs(_components.p,{children:[`Each identifier answered `,_jsx(_components.code,{children:`200`}),` uses one API credit. Every other result is\nfree, `,_jsx(_components.code,{children:`404`}),` included, and an identifier repeated in one request is charged\nonce. Available on paid plans and with prepaid credits. See\n`,_jsx(_components.a,{href:`/brand-api/overview#batch-lookups`,children:`Batch lookups`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Brand API batch","sidebarTitle":"/v2/brands/batch","openapi":"POST /v2/brands/batch","description":"Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way `GET /v2/brands/{identifier}` answers it.\n\nOne difference: 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.\n\nEach identifier answered `200` uses one API credit. Every other result is free, `404` included. An identifier repeated in one request is charged once.\n\nAvailable on paid plans and with prepaid credits. Authenticate with an API key sent as `Authorization: Bearer \u003ckey>`.","href":"/reference/brand-api-batch"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get up to 100 brands in one request","description":"Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way `GET /v2/brands/{identifier}` answers it.\n\nOne difference: 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.\n\nEach identifier answered `200` uses one API credit. Every other result is free, `404` included. An identifier repeated in one request is charged once.\n\nAvailable on paid plans and with prepaid credits. Authenticate with an API key sent as `Authorization: Bearer \u003ckey>`.","operationId":"getBrandBatch","tags":["brands"],"security":["317b2c2d-1ce8-494a-a637-3e862f7584fe"],"requestBody":"eda3d0dc-8267-4ba8-a64e-d7e8780a0034","responses":{"200":"59932fcf-0b2e-4721-86b5-10994af61fb4","400":"675736be-674f-4610-99af-64acdeebeec5","401":"081c6fc1-94a4-4ebd-8442-bb16bca96b69","403":"b0f20eb2-be82-497b-aae6-1d2420cb8117","429":"9b242cc4-416f-4728-bb88-541c7b926359"},"method":"post","type":"path","servers":["063de55c-2dbd-42fb-8380-d7a70325c243"],"path":"/v2/brands/batch","baseUrlOptions":["https://api.brandfetch.io"],"title":"Get up to 100 brands in one request","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["identifiers"],"properties":{"identifiers":{"type":"array","minItems":1,"maxItems":100,"description":"The brands to look up. A string is read as the `identifier` of `GET /v2/brands/{identifier}`: a domain, website URL, email address, brand ID, ticker or ISIN. An object names the identifier's type, as `GET /v2/brands/{type}/{identifier}` does. An exchange-suffixed ticker sent as a string, such as `bhp.ax`, is read as a domain: send it as `{ \"type\": \"ticker\", \"value\": \"BHP.AX\" }`.","items":{"oneOf":[{"type":"string","maxLength":2048,"minLength":1,"example":"nike.com","uniqueKey":"identifiers.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["type","value"],"example":{"type":"ticker","value":"NKE"},"properties":{"type":{"type":"string","enum":["domain","ticker","isin","crypto","brandId"],"isRequired":true,"uniqueKey":"identifiers.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","minLength":1,"maxLength":2048,"isRequired":true,"uniqueKey":"identifiers.items.[INDEX].oneOf.1.value","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"identifiers.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"identifiers.items.[INDEX]","typeLabel":"string | object"},"example":["nike.com","https://www.spotify.com/about",{"type":"ticker","value":"NKE"}],"isRequired":true,"uniqueKey":"identifiers","typeLabel":"(string | object)[]"},"cachedOnly":{"type":"boolean","default":false,"description":"Answer from the index alone. A brand that is not indexed is answered `204` and is not queued, and a ticker, ISIN or crypto symbol that is not indexed is not resolved. A `204` is free.","uniqueKey":"cachedOnly","typeLabel":"boolean"},"allowNsfw":{"type":"boolean","description":"As `allowNsfw` on `GET /v2/brands/{identifier}`. Not set by default.","uniqueKey":"allowNsfw","typeLabel":"boolean"},"palette":{"type":"boolean","default":false,"description":"As `palette` on `GET /v2/brands/{identifier}`: add each brand's `palette`.","uniqueKey":"palette","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"identifiers":["nike.com","https://www.spotify.com/about",{"type":"ticker","value":"NKE"}],"cachedOnly":false,"allowNsfw":true,"palette":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"59932fcf-0b2e-4721-86b5-10994af61fb4":{"description":"One result per identifier, in the order you sent them.","headers":{"x-api-key-quota":{"description":"Your organization's API credit quota for the current period.","schema":{"type":"integer"}},"x-api-key-approximate-usage":{"description":"Credits used this period, including the ones this request uses. Usage is counted asynchronously, so the figure trails your latest requests slightly.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","required":["identifier","status"],"properties":{"identifier":{"oneOf":[{"type":"string","description":"The identifier you sent, with surrounding whitespace removed.","isRequired":true,"uniqueKey":"results.items.[INDEX].identifier.oneOf.0","typeLabel":"string"},{"type":"object","description":"The identifier you sent, with surrounding whitespace removed.","isRequired":true,"uniqueKey":"results.items.[INDEX].identifier.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].identifier","typeLabel":"string | object"},"status":{"type":"integer","enum":[200,202,204,400,404,413,500,504],"description":"- `200` — `brand` holds the brand.\n- `202` — the brand is not indexed yet and is queued for indexing (`code`: `crawl_queued`). Request it again later. Free.\n- `204` — with `cachedOnly`, the brand is not indexed. Nothing is queued. Free.\n- `400` — not a valid identifier. `message` says why. Free.\n- `404` — no brand can be returned for the identifier. `message` gives the reason. Free.\n- `413` — the brand did not fit in this response (`code`: `response_too_large`). Request it again in a smaller batch. Free.\n- `500` — the identifier could not be looked up. Request it again. Free.\n- `504` — the identifier could not be looked up in time (`code`: `timeout`). Request it again. Free.","isRequired":true,"uniqueKey":"results.items.[INDEX].status","typeLabel":"enum\u003cinteger>"},"brand":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the brand","nullable":false,"uniqueKey":"results.items.[INDEX].brand.id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"Brand name","uniqueKey":"results.items.[INDEX].brand.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Brand name","uniqueKey":"results.items.[INDEX].brand.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.name","typeLabel":"string | null"},"domain":{"type":"string","description":"Brand website URL","nullable":false,"uniqueKey":"results.items.[INDEX].brand.domain","typeLabel":"string"},"claimed":{"type":"boolean","description":"Set to true if the owner of the brand claimed its brand profile on [Brandfetch](https://brandfetch.com)","nullable":false,"uniqueKey":"results.items.[INDEX].brand.claimed","typeLabel":"boolean"},"description":{"oneOf":[{"type":"string","description":"Brand description","uniqueKey":"results.items.[INDEX].brand.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Brand description","uniqueKey":"results.items.[INDEX].brand.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.description","typeLabel":"string | null"},"longDescription":{"oneOf":[{"type":"string","description":"Brand long description","uniqueKey":"results.items.[INDEX].brand.longDescription.oneOf.0","typeLabel":"string"},{"type":"null","description":"Brand long description","uniqueKey":"results.items.[INDEX].brand.longDescription.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.longDescription","typeLabel":"string | null"},"links":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the social media platform","nullable":false,"enum":["twitter","facebook","instagram","github","youtube","linkedin","crunchbase"],"uniqueKey":"results.items.[INDEX].brand.links.items.[INDEX].name","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"URL of the social media profile","nullable":false,"uniqueKey":"results.items.[INDEX].brand.links.items.[INDEX].url","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].brand.links.items.[INDEX]","typeLabel":"object"},"description":"Social media links of the brand","nullable":false,"uniqueKey":"results.items.[INDEX].brand.links","typeLabel":"object[]"},"logo":{"oneOf":[{"type":"string","description":"Shortcut field for the brand's logo: the address of the best match from `logos`. The image is a WebP up to 512 px on its longer side. A dark logo is picked over a light one, for light backgrounds; the address names the theme it serves. `null` when the brand has no logo, and for brands with `isNsfw: true`.\n\nFetch the address as it is given. Its `c` parameter is a client ID signed for your API key. The client ID is required, and a request without it is refused. Its `t` parameter changes when the image does, so you can cache the image for as long as you like. The image does not count towards your quota. If the logo is gone when you fetch it, the address returns `404`.","uniqueKey":"results.items.[INDEX].brand.logo.oneOf.0","typeLabel":"string"},{"type":"null","description":"Shortcut field for the brand's logo: the address of the best match from `logos`. The image is a WebP up to 512 px on its longer side. A dark logo is picked over a light one, for light backgrounds; the address names the theme it serves. `null` when the brand has no logo, and for brands with `isNsfw: true`.\n\nFetch the address as it is given. Its `c` parameter is a client ID signed for your API key. The client ID is required, and a request without it is refused. Its `t` parameter changes when the image does, so you can cache the image for as long as you like. The image does not count towards your quota. If the logo is gone when you fetch it, the address returns `404`.","uniqueKey":"results.items.[INDEX].brand.logo.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.logo","typeLabel":"string | null"},"symbol":{"oneOf":[{"type":"string","description":"Shortcut field for the brand's symbol: the address of the best match from `logos`. The image is a WebP up to 512 px on its longer side. A dark symbol is picked over a light one, for light backgrounds; the address names the theme it serves. `null` when the brand has no symbol, and for brands with `isNsfw: true`.\n\nFetch the address as it is given. Its `c` parameter is a client ID signed for your API key. The client ID is required, and a request without it is refused. Its `t` parameter changes when the image does, so you can cache the image for as long as you like. The image does not count towards your quota. If the symbol is gone when you fetch it, the address returns `404`.","uniqueKey":"results.items.[INDEX].brand.symbol.oneOf.0","typeLabel":"string"},{"type":"null","description":"Shortcut field for the brand's symbol: the address of the best match from `logos`. The image is a WebP up to 512 px on its longer side. A dark symbol is picked over a light one, for light backgrounds; the address names the theme it serves. `null` when the brand has no symbol, and for brands with `isNsfw: true`.\n\nFetch the address as it is given. Its `c` parameter is a client ID signed for your API key. The client ID is required, and a request without it is refused. Its `t` parameter changes when the image does, so you can cache the image for as long as you like. The image does not count towards your quota. If the symbol is gone when you fetch it, the address returns `404`.","uniqueKey":"results.items.[INDEX].brand.symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.symbol","typeLabel":"string | null"},"icon":{"oneOf":[{"type":"string","description":"Shortcut field for the brand's icon: the address of the best match from `logos`. The image is a square WebP up to 128 px. A brand without an icon gets one made from its symbol or logo. When no icon can be made, the address returns a lettermark: the brand's initial on a plain square. `null` when the brand has no icon, symbol or logo, and for brands with `isNsfw: true`.\n\nFetch the address as it is given. Its `c` parameter is a client ID signed for your API key. The client ID is required, and a request without it is refused. Its `t` parameter changes when the image does, so you can cache the image for as long as you like. The image does not count towards your quota.","uniqueKey":"results.items.[INDEX].brand.icon.oneOf.0","typeLabel":"string"},{"type":"null","description":"Shortcut field for the brand's icon: the address of the best match from `logos`. The image is a square WebP up to 128 px. A brand without an icon gets one made from its symbol or logo. When no icon can be made, the address returns a lettermark: the brand's initial on a plain square. `null` when the brand has no icon, symbol or logo, and for brands with `isNsfw: true`.\n\nFetch the address as it is given. Its `c` parameter is a client ID signed for your API key. The client ID is required, and a request without it is refused. Its `t` parameter changes when the image does, so you can cache the image for as long as you like. The image does not count towards your quota.","uniqueKey":"results.items.[INDEX].brand.icon.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.icon","typeLabel":"string | null"},"banner":{"oneOf":[{"type":"string","description":"Shortcut field for the brand's banner: the address of the best match from `images`. The image is a WebP up to 1500 px wide. `null` when the brand has no banner, and for brands with `isNsfw: true`.\n\nFetch the address as it is given. Its `c` parameter is a client ID signed for your API key. The client ID is required, and a request without it is refused. Its `t` parameter changes when the image does, so you can cache the image for as long as you like. The image does not count towards your quota. If the banner is gone when you fetch it, the address returns `404`.","uniqueKey":"results.items.[INDEX].brand.banner.oneOf.0","typeLabel":"string"},{"type":"null","description":"Shortcut field for the brand's banner: the address of the best match from `images`. The image is a WebP up to 1500 px wide. `null` when the brand has no banner, and for brands with `isNsfw: true`.\n\nFetch the address as it is given. Its `c` parameter is a client ID signed for your API key. The client ID is required, and a request without it is refused. Its `t` parameter changes when the image does, so you can cache the image for as long as you like. The image does not count towards your quota. If the banner is gone when you fetch it, the address returns `404`.","uniqueKey":"results.items.[INDEX].brand.banner.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.banner","typeLabel":"string | null"},"logos":{"type":"array","items":{"type":"object","properties":{"theme":{"oneOf":[{"type":"string","description":"See logo theme. Possible values:\n- **dark**: A dark logo should be displayed on a light background (e.g. #ffffff)\n- **light**: A light logo should be displayed on a dark background (e.g. #000000)","enum":["dark","light",null],"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].theme.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"See logo theme. Possible values:\n- **dark**: A dark logo should be displayed on a light background (e.g. #ffffff)\n- **light**: A light logo should be displayed on a dark background (e.g. #000000)","enum":["dark","light",null],"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].theme.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].theme","typeLabel":"enum\u003cstring> | null"},"formats":{"type":"array","items":{"type":"object","properties":{"src":{"type":"string","description":"File source","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].src","typeLabel":"string"},"format":{"type":"string","enum":["svg","webp","png","jpeg"],"description":"File format","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].format","typeLabel":"enum\u003cstring>"},"height":{"oneOf":[{"type":"integer","description":"File height in pixels","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].height.oneOf.0","typeLabel":"integer"},{"type":"null","description":"File height in pixels","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].height","typeLabel":"integer | null"},"width":{"oneOf":[{"type":"integer","description":"File width in pixels","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].width.oneOf.0","typeLabel":"integer"},{"type":"null","description":"File width in pixels","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].width","typeLabel":"integer | null"},"size":{"type":"integer","description":"File size in bytes","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].size","typeLabel":"integer"},"background":{"oneOf":[{"type":"string","enum":["transparent"],"description":"Indicates if the file has a transparent background","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].background.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["transparent"],"description":"Indicates if the file has a transparent background","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].background.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX].background","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats.items.[INDEX]","typeLabel":"object"},"description":"A list of format objects containing files in different formats","nullable":false,"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].formats","typeLabel":"object[]"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"description":"What the image is. Brandfetch tags a brand's icon and logo; one that is no longer the brand's main icon or logo keeps its tags and is listed with type `other`. Possible values:\n- **photographic**: The image is a photograph, or a logo shown on one, such as a sign or a vehicle.\n- **portrait**: The image is a photograph mainly of one or more people. An image tagged `portrait` is also tagged `photographic`.\n- **illustration**: The image is a drawing, painting, cartoon or 3D render that is not a logo.\n- **screenshot**: The image is a screenshot or mockup of software, a website, an app or a device screen. Logos only.\n- **text**: The image is a flyer, poster, advert, social media post, infographic, document or menu.\n- **placeholder**: The image is a default avatar, a blank or single-colour image, or a \"no image\" graphic.\n- **wordmark**: The logo is the brand's name set in type, with no separate symbol.\n- **lettermark**: The logo is initials, a monogram or a single letter. Icons only.\n- **symbol**: The logo is a symbol alone, without text. Icons only.\n- **combination**: The logo pairs a symbol with the name.\n- **emblem**: The logo's text sits inside a badge, seal or crest.\n\nThe mark types, `wordmark` to `emblem`, go only on an image that is mainly a logo, one at most. A tag is assigned only when the image clearly is one, so an image without a tag can still be any of these. Logos and icons that Brandfetch has not refreshed since October 2026 may carry fewer tags, or none. Brandfetch may add values.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].tags","typeLabel":"string[]"},"type":{"type":"string","description":"See logo type. Possible values:\n- **icon**: The icon that is used on social profiles (e.g. [Tesla's social icon](https://cdn.brandfetch.io/tesla.com/icon))\n- **logo**: The horizontal logo, seen on large surfaces (e.g. [Tesla's logo](https://asset.brandfetch.io/id2S-kXbuK/idAJ5NMLPG.svg))\n- **symbol**: The universal mark that abstractly represents the brand (e.g. [Tesla's T symbol](https://asset.brandfetch.io/id2S-kXbuK/idM-t614MT.svg))\n- **other**: Other is used to refer to any type of logo that is not the primary one. (e.g. Amazon Kindle Logo)","nullable":false,"enum":["icon","logo","symbol","other"],"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"results.items.[INDEX].brand.logos.items.[INDEX]","typeLabel":"object"},"description":"Logos, symbols \u0026 icons of the brand","nullable":false,"uniqueKey":"results.items.[INDEX].brand.logos","typeLabel":"object[]"},"colors":{"type":"array","items":{"type":"object","properties":{"hex":{"type":"string","description":"Color HEX code","nullable":false,"uniqueKey":"results.items.[INDEX].brand.colors.items.[INDEX].hex","typeLabel":"string"},"type":{"type":"string","description":"Type of the color. Possible values:\n- **accent**: The main color that represents the brand (used to draw attention e.g. call to action button)\n- **dark**: The darker color of the brand (used for surfaces or backgrounds)\n- **light**: The lighter color of the brand (used for surfaces or backgrounds)\n- **brand**: The full-color scheme of the brand (used to create color palettes users can pick from)","nullable":false,"enum":["accent","dark","light","brand"],"uniqueKey":"results.items.[INDEX].brand.colors.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"brightness":{"type":"number","description":"Color brightness. Calculated based on the standard formula 0.2126*R + 0.7152*G + 0.0722*B","nullable":false,"format":"float","uniqueKey":"results.items.[INDEX].brand.colors.items.[INDEX].brightness","typeLabel":"number\u003cfloat>"}},"uniqueKey":"results.items.[INDEX].brand.colors.items.[INDEX]","typeLabel":"object"},"description":"Accent, dark, light \u0026 palette colors of the brand","nullable":false,"uniqueKey":"results.items.[INDEX].brand.colors","typeLabel":"object[]"},"fonts":{"type":"array","items":{"type":"object","properties":{"name":{"oneOf":[{"type":"string","description":"Font family","uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Font family","uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].name","typeLabel":"string | null"},"type":{"type":"string","description":"Font type","nullable":false,"enum":["title","body"],"uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"origin":{"type":"string","description":"See font origin. Possible values:\n- **google**: The font that's hosted on Google Font\n- **custom**: The font that has been uploaded by the brand itself\n- **system**: The font that's already installed on the user's operating system (see example)","enum":["google","custom","system"],"uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].origin","typeLabel":"enum\u003cstring>"},"originId":{"oneOf":[{"type":"string","description":"Font origin ID","uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].originId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Font origin ID","uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].originId.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].originId","typeLabel":"string | null"},"weights":{"type":"array","items":{"type":"object","properties":{},"uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].weights.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX].weights","typeLabel":"object[]"}},"uniqueKey":"results.items.[INDEX].brand.fonts.items.[INDEX]","typeLabel":"object"},"description":"Title \u0026 body fonts of the brand","nullable":false,"uniqueKey":"results.items.[INDEX].brand.fonts","typeLabel":"object[]"},"images":{"type":"array","items":{"type":"object","properties":{"formats":{"type":"array","items":{"type":"object","properties":{"src":{"type":"string","description":"File source","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].src","typeLabel":"string"},"format":{"type":"string","enum":["svg","webp","png","jpeg"],"description":"File format","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].format","typeLabel":"enum\u003cstring>"},"height":{"oneOf":[{"type":"integer","description":"File height in pixels","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].height.oneOf.0","typeLabel":"integer"},{"type":"null","description":"File height in pixels","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].height","typeLabel":"integer | null"},"width":{"oneOf":[{"type":"integer","description":"File width in pixels","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].width.oneOf.0","typeLabel":"integer"},{"type":"null","description":"File width in pixels","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].width","typeLabel":"integer | null"},"size":{"type":"integer","description":"File size in bytes","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].size","typeLabel":"integer"},"background":{"oneOf":[{"type":"string","enum":["transparent"],"description":"Indicates if the file has a transparent background","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].background.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["transparent"],"description":"Indicates if the file has a transparent background","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].background.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX].background","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats.items.[INDEX]","typeLabel":"object"},"description":"Available formats of the image","nullable":false,"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].formats","typeLabel":"object[]"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"description":"What the image is. A banner that is no longer the brand's main one keeps its tags and is listed with type `other`. Possible values:\n- **photographic**: The image is a photograph, or a logo shown on one. Banners and pictures.\n- **portrait**: The image is a photograph mainly of one or more people. Banners and pictures. An image tagged `portrait` is also tagged `photographic`.\n- **illustration**: The image is a drawing, painting, cartoon or 3D render that is not a logo. Banners and pictures.\n- **screenshot**: The image is a screenshot or mockup of software, a website, an app or a device screen. Pictures.\n- **text**: The image is a flyer, poster, advert, social media post, infographic, document or menu. Banners and pictures.\n- **pattern**: The image is an abstract background, texture, gradient or pattern with no subject. Pictures.\n- **placeholder**: The image is blank, a single colour, or a \"no image\" graphic. Banners.\n\nA tag is assigned only when the image clearly is one, so an image without a tag can still be any of these. Images that Brandfetch has not refreshed since October 2026 have no tags. Brandfetch may add values.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].tags","typeLabel":"string[]"},"type":{"type":"string","description":"Image type. `picture` entries are images published on the brand's own site and carry `pictureMetadata`. Their `tags` say what each one is, such as a photograph, a screenshot or a flyer.","nullable":false,"enum":["banner","other","picture"],"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"pictureMetadata":{"type":"object","description":"Present on `picture` entries only. Lets you choose between a brand's pictures without fetching the files first.","properties":{"score":{"type":"number","description":"How representative of the brand we consider this picture","nullable":false,"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.score","typeLabel":"number"},"rank":{"type":"integer","description":"Position of this picture among the brand's pictures, by descending score","nullable":false,"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.rank","typeLabel":"integer"},"naturalWidth":{"type":"integer","description":"Intrinsic width of the image in pixels","nullable":false,"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.naturalWidth","typeLabel":"integer"},"naturalHeight":{"type":"integer","description":"Intrinsic height of the image in pixels","nullable":false,"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.naturalHeight","typeLabel":"integer"},"alt":{"type":"string","description":"Alt text published with the image on the brand's site","nullable":false,"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.alt","typeLabel":"string"},"sourceUrl":{"type":"string","description":"URL of the image on the brand's own site. A `picture` can arrive with an empty `formats` array, in which case this is how you reach the image.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.sourceUrl","typeLabel":"string"},"imageCategory":{"oneOf":[{"type":"string","description":"Category we classified the image into","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.imageCategory.oneOf.0","typeLabel":"string"},{"type":"null","description":"Category we classified the image into","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.imageCategory.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.imageCategory","typeLabel":"string | null"},"categoryConfidence":{"oneOf":[{"type":"number","description":"Confidence in the assigned `imageCategory`","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.categoryConfidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"Confidence in the assigned `imageCategory`","uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.categoryConfidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata.categoryConfidence","typeLabel":"number | null"}},"nullable":false,"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX].pictureMetadata","typeLabel":"object"}},"uniqueKey":"results.items.[INDEX].brand.images.items.[INDEX]","typeLabel":"object"},"description":"Banner, picture \u0026 other images of the brand","nullable":false,"uniqueKey":"results.items.[INDEX].brand.images","typeLabel":"object[]"},"qualityScore":{"type":"number","description":"Score between 0-1 which indicates the quality of the data for the given brand. Useful when you don't want to show lower quality brands to your users.\n\nLower 3rd is poor quality, middle 3rd is OK quality, upper 3rd is high quality. Lower scores indicate that a brand is less likely to be \"real\". For example, where google.com will score high, my-random-blog.com will score between 0.3-0.4. The score factors in things like data-recency, whether the brand has been claimed, if it has been manually verified by our team, the brand's domain ranking on the web, as well as other factors.\n\nDon't rely on a fixed score for any given brand. The way we calculate this score may change over time as we add new factors, or tweak the weights of existing ones such that a score for a given brand may change. However, they will remain aligned such that scores divide quality into thirds: low, medium, high.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.qualityScore","typeLabel":"number"},"company":{"type":"object","properties":{"employees":{"oneOf":[{"type":"integer","description":"1 employee, 2-10 employees, 11-50 employees, 51-200 employees, 201-500 employees, 501-1,000 employees, 1,001-5,000 employees, 5,001-10,000 employees, 10,001+ employees","enum":[1,2,11,51,201,501,1001,5001,10001],"uniqueKey":"results.items.[INDEX].brand.company.employees.oneOf.0","typeLabel":"enum\u003cinteger>"},{"type":"null","description":"1 employee, 2-10 employees, 11-50 employees, 51-200 employees, 201-500 employees, 501-1,000 employees, 1,001-5,000 employees, 5,001-10,000 employees, 10,001+ employees","enum":[1,2,11,51,201,501,1001,5001,10001],"uniqueKey":"results.items.[INDEX].brand.company.employees.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.employees","typeLabel":"enum\u003cinteger> | null"},"financialIdentifiers":{"oneOf":[{"type":"object","description":"Object holding financial identifiers","properties":{"isin":{"type":"array","description":"List of ISIN codes","items":{"type":"string","uniqueKey":"results.items.[INDEX].brand.company.financialIdentifiers.oneOf.0.isin.items.[INDEX]","typeLabel":"string"},"uniqueKey":"results.items.[INDEX].brand.company.financialIdentifiers.oneOf.0.isin","typeLabel":"string[]"},"ticker":{"type":"array","description":"List of Stock or ETF ticker","items":{"type":"string","uniqueKey":"results.items.[INDEX].brand.company.financialIdentifiers.oneOf.0.ticker.items.[INDEX]","typeLabel":"string"},"uniqueKey":"results.items.[INDEX].brand.company.financialIdentifiers.oneOf.0.ticker","typeLabel":"string[]"}},"uniqueKey":"results.items.[INDEX].brand.company.financialIdentifiers.oneOf.0","typeLabel":"object"},{"type":"null","description":"Object holding financial identifiers","properties":{"isin":{"type":"array","description":"List of ISIN codes","items":{"type":"string"}},"ticker":{"type":"array","description":"List of Stock or ETF ticker","items":{"type":"string"}}},"uniqueKey":"results.items.[INDEX].brand.company.financialIdentifiers.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.financialIdentifiers","typeLabel":"object | null"},"foundedYear":{"oneOf":[{"type":"integer","description":"The year the brand was founded","uniqueKey":"results.items.[INDEX].brand.company.foundedYear.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The year the brand was founded","uniqueKey":"results.items.[INDEX].brand.company.foundedYear.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.foundedYear","typeLabel":"integer | null"},"industries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the industry","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].id","typeLabel":"string"},"score":{"type":"number","format":"float","description":"Probability, between 0 and 1, that the brand belongs to this industry. A value of 1 marks an industry that was set rather than predicted, for example by a curator, an import or a content rule.","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].score","typeLabel":"number\u003cfloat>"},"slug":{"type":"string","description":"URL friendly identifier","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","description":"Name of the industry","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].name","typeLabel":"string"},"emoji":{"type":"string","description":"An emoji for the industry","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].emoji","typeLabel":"string"},"parent":{"oneOf":[{"description":"If the object is a sub-category, the parent industry","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the industry","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].parent.oneOf.0.items.[INDEX].id","typeLabel":"string"},"slug":{"type":"string","description":"URL friendly identifier","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].parent.oneOf.0.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","description":"Name of the industry","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].parent.oneOf.0.items.[INDEX].name","typeLabel":"string"},"emoji":{"type":"string","description":"An emoji for the industry","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].parent.oneOf.0.items.[INDEX].emoji","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].parent.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].parent.oneOf.0","typeLabel":"object[]"},{"description":"If the object is a sub-category, the parent industry","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the industry"},"slug":{"type":"string","description":"URL friendly identifier"},"name":{"type":"string","description":"Name of the industry"},"emoji":{"type":"string","description":"An emoji for the industry"}}},"type":"null","uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].parent.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX].parent","typeLabel":"object[] | null"}},"uniqueKey":"results.items.[INDEX].brand.company.industries.items.[INDEX]","typeLabel":"object"},"description":"An array of industries, sorted by descending `score`. A sub-industry carries its top-level industry in `parent`. See the full list of industries [here](https://docs.google.com/spreadsheets/d/1N44nMfVtPCFM4ebTcmRlqbyxjFtDAGVuqd0mh0dcOU0/edit?usp=sharing)","uniqueKey":"results.items.[INDEX].brand.company.industries","typeLabel":"object[]"},"kind":{"oneOf":[{"type":"string","description":"Organizational Structure","enum":["EDUCATIONAL","GOVERNMENT_AGENCY","NON_PROFIT","PARTNERSHIP","PRIVATELY_HELD","PUBLIC_COMPANY","SELF_EMPLOYED","SELF_OWNED"],"uniqueKey":"results.items.[INDEX].brand.company.kind.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Organizational Structure","enum":["EDUCATIONAL","GOVERNMENT_AGENCY","NON_PROFIT","PARTNERSHIP","PRIVATELY_HELD","PUBLIC_COMPANY","SELF_EMPLOYED","SELF_OWNED"],"uniqueKey":"results.items.[INDEX].brand.company.kind.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.kind","typeLabel":"enum\u003cstring> | null"},"location":{"type":"object","description":"Company's headquarter information","properties":{"city":{"oneOf":[{"type":"string","description":"Headquarter city","uniqueKey":"results.items.[INDEX].brand.company.location.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"Headquarter city","uniqueKey":"results.items.[INDEX].brand.company.location.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.location.city","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","description":"Headquarter country","uniqueKey":"results.items.[INDEX].brand.company.location.country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Headquarter country","uniqueKey":"results.items.[INDEX].brand.company.location.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.location.country","typeLabel":"string | null"},"countryCode":{"oneOf":[{"type":"string","description":"Headquarter country code (ISO 3166-1 alpha-2)","uniqueKey":"results.items.[INDEX].brand.company.location.countryCode.oneOf.0","typeLabel":"string"},{"type":"null","description":"Headquarter country code (ISO 3166-1 alpha-2)","uniqueKey":"results.items.[INDEX].brand.company.location.countryCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.location.countryCode","typeLabel":"string | null"},"region":{"oneOf":[{"type":"string","description":"Headquarter region","uniqueKey":"results.items.[INDEX].brand.company.location.region.oneOf.0","typeLabel":"string"},{"type":"null","description":"Headquarter region","uniqueKey":"results.items.[INDEX].brand.company.location.region.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.location.region","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","description":"Headquarter state","uniqueKey":"results.items.[INDEX].brand.company.location.state.oneOf.0","typeLabel":"string"},{"type":"null","description":"Headquarter state","uniqueKey":"results.items.[INDEX].brand.company.location.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.location.state","typeLabel":"string | null"},"subregion":{"oneOf":[{"type":"string","description":"Headquarter subregion","uniqueKey":"results.items.[INDEX].brand.company.location.subregion.oneOf.0","typeLabel":"string"},{"type":"null","description":"Headquarter subregion","uniqueKey":"results.items.[INDEX].brand.company.location.subregion.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.company.location.subregion","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX].brand.company.location","typeLabel":"object"}},"description":"The company object returns firmographic data related to the brand","nullable":false,"uniqueKey":"results.items.[INDEX].brand.company","typeLabel":"object"},"isNsfw":{"type":"boolean","description":"true when the brand is for adult content, e.g. is not safe for work","nullable":false,"uniqueKey":"results.items.[INDEX].brand.isNsfw","typeLabel":"boolean"},"urn":{"type":"string","description":"Uniform Resource Name for the brand","nullable":false,"uniqueKey":"results.items.[INDEX].brand.urn","typeLabel":"string"},"screenshot":{"oneOf":[{"type":"object","description":"The brand's homepage screenshot. `null` when Brandfetch holds no screenshot of the homepage yet, and for brands with `isNsfw: true`.\n\nThe screenshot shows the top of the homepage at a desktop viewport, as Brandfetch saw it on its last visit. It is not a full-page capture. Fetch `url` as it is given: its `c` parameter is a client ID signed for your API key, and the image does not count towards your quota. A request that drops the client ID is refused. `t` is the time of capture, so the address changes when Brandfetch takes a new screenshot.","properties":{"url":{"type":"string","description":"The address of the PNG, signed for your API key. Fetch it as it is given, with its `c` and `t` parameters.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.screenshot.oneOf.0.url","typeLabel":"string"},"capturedAt":{"type":"string","format":"date-time","description":"When Brandfetch took the screenshot.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.screenshot.oneOf.0.capturedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"results.items.[INDEX].brand.screenshot.oneOf.0","typeLabel":"object"},{"type":"null","description":"The brand's homepage screenshot. `null` when Brandfetch holds no screenshot of the homepage yet, and for brands with `isNsfw: true`.\n\nThe screenshot shows the top of the homepage at a desktop viewport, as Brandfetch saw it on its last visit. It is not a full-page capture. Fetch `url` as it is given: its `c` parameter is a client ID signed for your API key, and the image does not count towards your quota. A request that drops the client ID is refused. `t` is the time of capture, so the address changes when Brandfetch takes a new screenshot.","properties":{"url":{"type":"string","description":"The address of the PNG, signed for your API key. Fetch it as it is given, with its `c` and `t` parameters.","nullable":false},"capturedAt":{"type":"string","format":"date-time","description":"When Brandfetch took the screenshot.","nullable":false}},"uniqueKey":"results.items.[INDEX].brand.screenshot.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.screenshot","typeLabel":"object | null"},"palette":{"oneOf":[{"type":"object","description":"The brand's color palette. Present only when the request sets `palette=true` or `palette=1`. When a brand has no palette yet, the first request builds one from the brand's last crawl without a new render. Then `themes` and `onPairs` can be empty until the next crawl. When Brandfetch finds no color that it can defend as the brand's color, no color has the role `primary`.","properties":{"colors":{"type":"array","items":{"type":"object","properties":{"hex":{"type":"string","description":"Color HEX code.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].hex","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"Name of the closest named color. Uses the same list as `colors[].name`, so the same HEX code has the same name everywhere.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the closest named color. Uses the same list as `colors[].name`, so the same HEX code has the same name everywhere.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].name","typeLabel":"string | null"},"role":{"type":"string","description":"What the color does for the brand. Possible values: `primary`, `secondary`, `accent`, `background`, `surface`, `text`, `muted`, `border`, `other`.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].role","typeLabel":"string"},"context":{"type":"string","description":"Where Brandfetch observed the color. `identity` for colors of the brand's mark and identity, `interface` for colors that structure its website, `both` for colors that do both.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].context","typeLabel":"string"},"rank":{"oneOf":[{"type":"integer","description":"Position of the color in the palette, from 1. `null` for a color that a theme, gradient, on-pair, or logo references but that does not rank as a brand color.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].rank.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Position of the color in the palette, from 1. `null` for a color that a theme, gradient, on-pair, or logo references but that does not rank as a brand color.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].rank.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].rank","typeLabel":"integer | null"},"member":{"type":"boolean","description":"`true` for a color listed only because a theme, gradient, on-pair or logo references it. Absent on ranked colors.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].member","typeLabel":"boolean"},"legibleText":{"type":"string","description":"`#ffffff` or `#000000`, whichever reads better on this color.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].legibleText","typeLabel":"string"},"legibleTextContrast":{"type":"number","description":"WCAG contrast ratio between the color and `legibleText`.","nullable":false,"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].legibleTextContrast","typeLabel":"number"},"onColor":{"oneOf":[{"type":"string","description":"The text color that the brand's website places on this color, when Brandfetch observed it.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].onColor.oneOf.0","typeLabel":"string"},{"type":"null","description":"The text color that the brand's website places on this color, when Brandfetch observed it.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].onColor.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].onColor","typeLabel":"string | null"},"onColorContrast":{"oneOf":[{"type":"number","description":"WCAG contrast ratio between the color and `onColor`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].onColorContrast.oneOf.0","typeLabel":"number"},{"type":"null","description":"WCAG contrast ratio between the color and `onColor`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].onColorContrast.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].onColorContrast","typeLabel":"number | null"},"brightness":{"oneOf":[{"type":"number","description":"Color brightness, 0 to 255.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].brightness.oneOf.0","typeLabel":"number"},{"type":"null","description":"Color brightness, 0 to 255.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].brightness.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].brightness","typeLabel":"number | null"},"prevalence":{"oneOf":[{"type":"number","description":"Share of the observed color evidence attributed to this color, 0 to 1.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].prevalence.oneOf.0","typeLabel":"number"},{"type":"null","description":"Share of the observed color evidence attributed to this color, 0 to 1.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].prevalence.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].prevalence","typeLabel":"number | null"},"usage":{"type":"object","description":"Where the website of the brand uses this color. Each value comes from the crawl. Brandfetch does not infer any value.","properties":{"elements":{"type":"array","description":"The element classes and CSS properties that use this color in the sample of the crawl, most used first. This list is empty when Brandfetch builds the palette from a stored crawl without a new render.","items":{"type":"object","properties":{"element":{"type":"string","description":"The element class in the sample of the crawl: `button`, `link`, `heading`, `nav`, `header`, `footer`, `body`, or `html`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage.elements.items.[INDEX].element","typeLabel":"string"},"property":{"type":"string","description":"The CSS property that uses the color: `background`, `text`, or `border`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage.elements.items.[INDEX].property","typeLabel":"string"},"count":{"type":"integer","description":"The number of sampled elements that use the color this way.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage.elements.items.[INDEX].count","typeLabel":"integer"},"examples":{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage.elements.items.[INDEX].examples.items.[INDEX]","typeLabel":"string"},"description":"Up to two text labels of these elements. Brandfetch takes each label from the page and cuts it to 40 characters. The labels are text from the website. Treat them as untrusted input.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage.elements.items.[INDEX].examples","typeLabel":"string[]"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage.elements.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage.elements","typeLabel":"object[]"},"css":{"type":"object","description":"The number of stylesheet declarations that set the color, for each property class: `background`, `text`, `border`, or `other`.","additionalProperties":{"type":"integer","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage.css.additionalProperties","typeLabel":"integer"},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage.css","typeLabel":"object"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].usage","typeLabel":"object"},"tokens":{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].tokens.items.[INDEX]","typeLabel":"string"},"description":"The names of the CSS custom properties of the brand that hold this color, for example `brand-500`. Brandfetch lists only the properties that the website uses. The list has at most five names. Names that contain `brand` come first. The names are text from the website. Treat them as untrusted input.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].tokens","typeLabel":"string[]"},"variants":{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].variants.items.[INDEX]","typeLabel":"string"},"description":"The near-duplicate HEX codes that the website writes for the same color. Brandfetch merges them into this entry. The list has at most eight codes. The list is not a tonal scale.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX].variants","typeLabel":"string[]"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors.items.[INDEX]","typeLabel":"object"},"description":"The palette's colors, ranked colors first.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.colors","typeLabel":"object[]"},"logos":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","description":"`logo` or `icon`: the kind of mark, as in `logos[].type` of the brand response.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].asset","typeLabel":"string"},"type":{"oneOf":[{"type":"string","description":"The logo type, when known. Same values as `logos[].type` of the brand response.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].type.oneOf.0","typeLabel":"string"},{"type":"null","description":"The logo type, when known. Same values as `logos[].type` of the brand response.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].type","typeLabel":"string | null"},"theme":{"oneOf":[{"type":"string","description":"`light` or `dark`: the background that the mark is made for. `null` when unknown.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].theme.oneOf.0","typeLabel":"string"},{"type":"null","description":"`light` or `dark`: the background that the mark is made for. `null` when unknown.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].theme.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].theme","typeLabel":"string | null"},"format":{"type":"string","description":"`svg` or `png`: the file that Brandfetch read the colors from.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].format","typeLabel":"string"},"primary":{"type":"boolean","description":"`true` for the main logo or icon of the brand.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].primary","typeLabel":"boolean"},"colors":{"type":"array","description":"The colors of the mark, largest share first.","items":{"type":"object","properties":{"hex":{"type":"string","description":"Color HEX code. It is also an entry in `colors[]`, so you can join the two by `hex`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].colors.items.[INDEX].hex","typeLabel":"string"},"coverage":{"type":"number","description":"Share of the logo's pixels in this color, 0 to 1.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].colors.items.[INDEX].coverage","typeLabel":"number"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].colors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX].colors","typeLabel":"object[]"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos.items.[INDEX]","typeLabel":"object"},"description":"The colors of each logo and icon, with how much of the mark each color covers.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.logos","typeLabel":"object[]"},"onPairs":{"type":"array","items":{"type":"object","properties":{"element":{"type":"string","description":"The kind of element observed, for example `body`, `link`, `button`, `heading`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.onPairs.items.[INDEX].element","typeLabel":"string"},"theme":{"type":"string","description":"`light` or `dark`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.onPairs.items.[INDEX].theme","typeLabel":"string"},"background":{"type":"string","description":"The background color HEX code. It is also an entry in `colors[]`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.onPairs.items.[INDEX].background","typeLabel":"string"},"text":{"type":"string","description":"The text color HEX code. It is also an entry in `colors[]`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.onPairs.items.[INDEX].text","typeLabel":"string"},"contrast":{"type":"number","description":"WCAG contrast ratio between `background` and `text`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.onPairs.items.[INDEX].contrast","typeLabel":"number"},"wcag":{"type":"string","description":"`AAA`, `AA`, `AA-large` or `fail`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.onPairs.items.[INDEX].wcag","typeLabel":"string"},"count":{"type":"integer","description":"How many elements showed this pair.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.onPairs.items.[INDEX].count","typeLabel":"integer"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.onPairs.items.[INDEX]","typeLabel":"object"},"description":"The background and text color pairs that Brandfetch observed on the brand's website, with their contrast. Empty for a palette built from a stored crawl without a new render.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.onPairs","typeLabel":"object[]"},"gradients":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","description":"Position of the gradient, from 1.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].rank","typeLabel":"integer"},"type":{"type":"string","description":"`linear`, `radial`, or `conic`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].type","typeLabel":"string"},"angle":{"oneOf":[{"type":"number","description":"The angle of a linear gradient, in degrees. `null` when the stylesheet gives none.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].angle.oneOf.0","typeLabel":"number"},{"type":"null","description":"The angle of a linear gradient, in degrees. `null` when the stylesheet gives none.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].angle.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].angle","typeLabel":"number | null"},"stops":{"type":"array","description":"The color stops, in order.","items":{"type":"object","properties":{"hex":{"type":"string","description":"Color HEX code. It is also an entry in `colors[]`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].stops.items.[INDEX].hex","typeLabel":"string"},"position":{"oneOf":[{"type":"number","description":"Position of the stop, 0 to 1. `null` when the stylesheet gives none.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].stops.items.[INDEX].position.oneOf.0","typeLabel":"number"},{"type":"null","description":"Position of the stop, 0 to 1. `null` when the stylesheet gives none.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].stops.items.[INDEX].position.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].stops.items.[INDEX].position","typeLabel":"number | null"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].stops.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].stops","typeLabel":"object[]"},"css":{"type":"string","description":"The gradient as a CSS value, for example `linear-gradient(90deg, #ff0000 0%, #0000ff 100%)`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX].css","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients.items.[INDEX]","typeLabel":"object"},"description":"Gradients from the brand's stylesheets that use a brand color, at most four. Every stop color is also an entry in `colors[]`, with `rank: null` when it is not a brand color.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.gradients","typeLabel":"object[]"},"themes":{"type":"object","description":"The `light` and `dark` themes that the website showed. A theme that Brandfetch did not observe is absent. A palette built from a stored crawl without a new render often has no themes.","properties":{"light":{"type":"object","description":"One theme of the brand's website. Each slot holds a color that the render of this theme showed. A slot that the render did not show is `null`. Every color is also an entry in `colors[]`.","properties":{"background":{"type":"string","description":"The page background color HEX code.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.background","typeLabel":"string"},"surface":{"oneOf":[{"type":"string","description":"The color HEX code of cards and panels on the page background.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.surface.oneOf.0","typeLabel":"string"},{"type":"null","description":"The color HEX code of cards and panels on the page background.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.surface.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.surface","typeLabel":"string | null"},"text":{"type":"string","description":"The body text color HEX code.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.text","typeLabel":"string"},"muted":{"oneOf":[{"type":"string","description":"The color HEX code of secondary text.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.muted.oneOf.0","typeLabel":"string"},{"type":"null","description":"The color HEX code of secondary text.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.muted.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.muted","typeLabel":"string | null"},"border":{"oneOf":[{"type":"string","description":"The color HEX code of borders and dividers.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.border.oneOf.0","typeLabel":"string"},{"type":"null","description":"The color HEX code of borders and dividers.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.border.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.border","typeLabel":"string | null"},"accent":{"oneOf":[{"type":"string","description":"The color HEX code of links and buttons in this theme.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.accent.oneOf.0","typeLabel":"string"},{"type":"null","description":"The color HEX code of links and buttons in this theme.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.accent.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.accent","typeLabel":"string | null"},"contrast":{"type":"number","description":"WCAG contrast ratio between `background` and `text`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light.contrast","typeLabel":"number"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.light","typeLabel":"object"},"dark":{"type":"object","description":"One theme of the brand's website. Each slot holds a color that the render of this theme showed. A slot that the render did not show is `null`. Every color is also an entry in `colors[]`.","properties":{"background":{"type":"string","description":"The page background color HEX code.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.background","typeLabel":"string"},"surface":{"oneOf":[{"type":"string","description":"The color HEX code of cards and panels on the page background.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.surface.oneOf.0","typeLabel":"string"},{"type":"null","description":"The color HEX code of cards and panels on the page background.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.surface.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.surface","typeLabel":"string | null"},"text":{"type":"string","description":"The body text color HEX code.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.text","typeLabel":"string"},"muted":{"oneOf":[{"type":"string","description":"The color HEX code of secondary text.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.muted.oneOf.0","typeLabel":"string"},{"type":"null","description":"The color HEX code of secondary text.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.muted.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.muted","typeLabel":"string | null"},"border":{"oneOf":[{"type":"string","description":"The color HEX code of borders and dividers.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.border.oneOf.0","typeLabel":"string"},{"type":"null","description":"The color HEX code of borders and dividers.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.border.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.border","typeLabel":"string | null"},"accent":{"oneOf":[{"type":"string","description":"The color HEX code of links and buttons in this theme.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.accent.oneOf.0","typeLabel":"string"},{"type":"null","description":"The color HEX code of links and buttons in this theme.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.accent.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.accent","typeLabel":"string | null"},"contrast":{"type":"number","description":"WCAG contrast ratio between `background` and `text`.","uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark.contrast","typeLabel":"number"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes.dark","typeLabel":"object"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0.themes","typeLabel":"object"}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.0","typeLabel":"object"},{"type":"null","description":"The brand's color palette. Present only when the request sets `palette=true` or `palette=1`. When a brand has no palette yet, the first request builds one from the brand's last crawl without a new render. Then `themes` and `onPairs` can be empty until the next crawl. When Brandfetch finds no color that it can defend as the brand's color, no color has the role `primary`.","properties":{"colors":{"type":"array","items":{"type":"object","properties":{"hex":{"type":"string","description":"Color HEX code.","nullable":false},"name":{"oneOf":[{"type":"string","description":"Name of the closest named color. Uses the same list as `colors[].name`, so the same HEX code has the same name everywhere."},{"type":"null","description":"Name of the closest named color. Uses the same list as `colors[].name`, so the same HEX code has the same name everywhere."}]},"role":{"type":"string","description":"What the color does for the brand. Possible values: `primary`, `secondary`, `accent`, `background`, `surface`, `text`, `muted`, `border`, `other`.","nullable":false},"context":{"type":"string","description":"Where Brandfetch observed the color. `identity` for colors of the brand's mark and identity, `interface` for colors that structure its website, `both` for colors that do both.","nullable":false},"rank":{"oneOf":[{"type":"integer","description":"Position of the color in the palette, from 1. `null` for a color that a theme, gradient, on-pair, or logo references but that does not rank as a brand color."},{"type":"null","description":"Position of the color in the palette, from 1. `null` for a color that a theme, gradient, on-pair, or logo references but that does not rank as a brand color."}]},"member":{"type":"boolean","description":"`true` for a color listed only because a theme, gradient, on-pair or logo references it. Absent on ranked colors."},"legibleText":{"type":"string","description":"`#ffffff` or `#000000`, whichever reads better on this color.","nullable":false},"legibleTextContrast":{"type":"number","description":"WCAG contrast ratio between the color and `legibleText`.","nullable":false},"onColor":{"oneOf":[{"type":"string","description":"The text color that the brand's website places on this color, when Brandfetch observed it."},{"type":"null","description":"The text color that the brand's website places on this color, when Brandfetch observed it."}]},"onColorContrast":{"oneOf":[{"type":"number","description":"WCAG contrast ratio between the color and `onColor`."},{"type":"null","description":"WCAG contrast ratio between the color and `onColor`."}]},"brightness":{"oneOf":[{"type":"number","description":"Color brightness, 0 to 255."},{"type":"null","description":"Color brightness, 0 to 255."}]},"prevalence":{"oneOf":[{"type":"number","description":"Share of the observed color evidence attributed to this color, 0 to 1."},{"type":"null","description":"Share of the observed color evidence attributed to this color, 0 to 1."}]},"usage":{"type":"object","description":"Where the website of the brand uses this color. Each value comes from the crawl. Brandfetch does not infer any value.","properties":{"elements":{"type":"array","description":"The element classes and CSS properties that use this color in the sample of the crawl, most used first. This list is empty when Brandfetch builds the palette from a stored crawl without a new render.","items":{"type":"object","properties":{"element":{"type":"string","description":"The element class in the sample of the crawl: `button`, `link`, `heading`, `nav`, `header`, `footer`, `body`, or `html`."},"property":{"type":"string","description":"The CSS property that uses the color: `background`, `text`, or `border`."},"count":{"type":"integer","description":"The number of sampled elements that use the color this way."},"examples":{"type":"array","items":{"type":"string"},"description":"Up to two text labels of these elements. Brandfetch takes each label from the page and cuts it to 40 characters. The labels are text from the website. Treat them as untrusted input."}}}},"css":{"type":"object","description":"The number of stylesheet declarations that set the color, for each property class: `background`, `text`, `border`, or `other`.","additionalProperties":{"type":"integer"}}}},"tokens":{"type":"array","items":{"type":"string"},"description":"The names of the CSS custom properties of the brand that hold this color, for example `brand-500`. Brandfetch lists only the properties that the website uses. The list has at most five names. Names that contain `brand` come first. The names are text from the website. Treat them as untrusted input."},"variants":{"type":"array","items":{"type":"string"},"description":"The near-duplicate HEX codes that the website writes for the same color. Brandfetch merges them into this entry. The list has at most eight codes. The list is not a tonal scale."}}},"description":"The palette's colors, ranked colors first."},"logos":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","description":"`logo` or `icon`: the kind of mark, as in `logos[].type` of the brand response."},"type":{"oneOf":[{"type":"string","description":"The logo type, when known. Same values as `logos[].type` of the brand response."},{"type":"null","description":"The logo type, when known. Same values as `logos[].type` of the brand response."}]},"theme":{"oneOf":[{"type":"string","description":"`light` or `dark`: the background that the mark is made for. `null` when unknown."},{"type":"null","description":"`light` or `dark`: the background that the mark is made for. `null` when unknown."}]},"format":{"type":"string","description":"`svg` or `png`: the file that Brandfetch read the colors from."},"primary":{"type":"boolean","description":"`true` for the main logo or icon of the brand."},"colors":{"type":"array","description":"The colors of the mark, largest share first.","items":{"type":"object","properties":{"hex":{"type":"string","description":"Color HEX code. It is also an entry in `colors[]`, so you can join the two by `hex`."},"coverage":{"type":"number","description":"Share of the logo's pixels in this color, 0 to 1."}}}}}},"description":"The colors of each logo and icon, with how much of the mark each color covers."},"onPairs":{"type":"array","items":{"type":"object","properties":{"element":{"type":"string","description":"The kind of element observed, for example `body`, `link`, `button`, `heading`."},"theme":{"type":"string","description":"`light` or `dark`."},"background":{"type":"string","description":"The background color HEX code. It is also an entry in `colors[]`."},"text":{"type":"string","description":"The text color HEX code. It is also an entry in `colors[]`."},"contrast":{"type":"number","description":"WCAG contrast ratio between `background` and `text`."},"wcag":{"type":"string","description":"`AAA`, `AA`, `AA-large` or `fail`."},"count":{"type":"integer","description":"How many elements showed this pair."}}},"description":"The background and text color pairs that Brandfetch observed on the brand's website, with their contrast. Empty for a palette built from a stored crawl without a new render."},"gradients":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","description":"Position of the gradient, from 1."},"type":{"type":"string","description":"`linear`, `radial`, or `conic`."},"angle":{"oneOf":[{"type":"number","description":"The angle of a linear gradient, in degrees. `null` when the stylesheet gives none."},{"type":"null","description":"The angle of a linear gradient, in degrees. `null` when the stylesheet gives none."}]},"stops":{"type":"array","description":"The color stops, in order.","items":{"type":"object","properties":{"hex":{"type":"string","description":"Color HEX code. It is also an entry in `colors[]`."},"position":{"oneOf":[{"type":"number","description":"Position of the stop, 0 to 1. `null` when the stylesheet gives none."},{"type":"null","description":"Position of the stop, 0 to 1. `null` when the stylesheet gives none."}]}}}},"css":{"type":"string","description":"The gradient as a CSS value, for example `linear-gradient(90deg, #ff0000 0%, #0000ff 100%)`."}}},"description":"Gradients from the brand's stylesheets that use a brand color, at most four. Every stop color is also an entry in `colors[]`, with `rank: null` when it is not a brand color."},"themes":{"type":"object","description":"The `light` and `dark` themes that the website showed. A theme that Brandfetch did not observe is absent. A palette built from a stored crawl without a new render often has no themes.","properties":{"light":{"type":"object","description":"One theme of the brand's website. Each slot holds a color that the render of this theme showed. A slot that the render did not show is `null`. Every color is also an entry in `colors[]`.","properties":{"background":{"type":"string","description":"The page background color HEX code."},"surface":{"oneOf":[{"type":"string","description":"The color HEX code of cards and panels on the page background."},{"type":"null","description":"The color HEX code of cards and panels on the page background."}]},"text":{"type":"string","description":"The body text color HEX code."},"muted":{"oneOf":[{"type":"string","description":"The color HEX code of secondary text."},{"type":"null","description":"The color HEX code of secondary text."}]},"border":{"oneOf":[{"type":"string","description":"The color HEX code of borders and dividers."},{"type":"null","description":"The color HEX code of borders and dividers."}]},"accent":{"oneOf":[{"type":"string","description":"The color HEX code of links and buttons in this theme."},{"type":"null","description":"The color HEX code of links and buttons in this theme."}]},"contrast":{"type":"number","description":"WCAG contrast ratio between `background` and `text`."}}},"dark":{"type":"object","description":"One theme of the brand's website. Each slot holds a color that the render of this theme showed. A slot that the render did not show is `null`. Every color is also an entry in `colors[]`.","properties":{"background":{"type":"string","description":"The page background color HEX code."},"surface":{"oneOf":[{"type":"string","description":"The color HEX code of cards and panels on the page background."},{"type":"null","description":"The color HEX code of cards and panels on the page background."}]},"text":{"type":"string","description":"The body text color HEX code."},"muted":{"oneOf":[{"type":"string","description":"The color HEX code of secondary text."},{"type":"null","description":"The color HEX code of secondary text."}]},"border":{"oneOf":[{"type":"string","description":"The color HEX code of borders and dividers."},{"type":"null","description":"The color HEX code of borders and dividers."}]},"accent":{"oneOf":[{"type":"string","description":"The color HEX code of links and buttons in this theme."},{"type":"null","description":"The color HEX code of links and buttons in this theme."}]},"contrast":{"type":"number","description":"WCAG contrast ratio between `background` and `text`."}}}}}},"uniqueKey":"results.items.[INDEX].brand.palette.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand.palette","typeLabel":"object | null"}},"uniqueKey":"results.items.[INDEX].brand","typeLabel":"object"},"code":{"type":"string","enum":["crawl_queued","response_too_large","timeout"],"uniqueKey":"results.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"results.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"identifier":"\u003cstring>","status":200,"brand":{"id":"\u003cstring>","name":"\u003cstring>","domain":"\u003cstring>","claimed":true,"description":"\u003cstring>","longDescription":"\u003cstring>","links":[{"name":"twitter","url":"\u003cstring>"}],"logo":"\u003cstring>","symbol":"\u003cstring>","icon":"\u003cstring>","banner":"\u003cstring>","logos":[{"theme":"dark","formats":[{"src":"\u003cstring>","format":"svg","height":123,"width":123,"size":123,"background":"transparent"}],"tags":["\u003cstring>"],"type":"icon"}],"colors":[{"hex":"\u003cstring>","type":"accent","brightness":123}],"fonts":[{"name":"\u003cstring>","type":"title","origin":"google","originId":"\u003cstring>","weights":[{}]}],"images":[{"formats":[{"src":"\u003cstring>","format":"svg","height":123,"width":123,"size":123,"background":"transparent"}],"tags":["\u003cstring>"],"type":"banner","pictureMetadata":{"score":123,"rank":123,"naturalWidth":123,"naturalHeight":123,"alt":"\u003cstring>","sourceUrl":"\u003cstring>","imageCategory":"\u003cstring>","categoryConfidence":123}}],"qualityScore":123,"company":{"employees":1,"financialIdentifiers":{"isin":["\u003cstring>"],"ticker":["\u003cstring>"]},"foundedYear":123,"industries":[{"id":"\u003cstring>","score":123,"slug":"\u003cstring>","name":"\u003cstring>","emoji":"\u003cstring>","parent":[{"id":"\u003cstring>","slug":"\u003cstring>","name":"\u003cstring>","emoji":"\u003cstring>"}]}],"kind":"EDUCATIONAL","location":{"city":"\u003cstring>","country":"\u003cstring>","countryCode":"\u003cstring>","region":"\u003cstring>","state":"\u003cstring>","subregion":"\u003cstring>"}},"isNsfw":true,"urn":"\u003cstring>","screenshot":{"url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"},"palette":{"colors":[{"hex":"\u003cstring>","name":"\u003cstring>","role":"\u003cstring>","context":"\u003cstring>","rank":123,"member":true,"legibleText":"\u003cstring>","legibleTextContrast":123,"onColor":"\u003cstring>","onColorContrast":123,"brightness":123,"prevalence":123,"usage":{"elements":[{"element":"\u003cstring>","property":"\u003cstring>","count":123,"examples":["\u003cstring>"]}],"css":{}},"tokens":["\u003cstring>"],"variants":["\u003cstring>"]}],"logos":[{"asset":"\u003cstring>","type":"\u003cstring>","theme":"\u003cstring>","format":"\u003cstring>","primary":true,"colors":[{"hex":"\u003cstring>","coverage":123}]}],"onPairs":[{"element":"\u003cstring>","theme":"\u003cstring>","background":"\u003cstring>","text":"\u003cstring>","contrast":123,"wcag":"\u003cstring>","count":123}],"gradients":[{"rank":123,"type":"\u003cstring>","angle":123,"stops":[{"hex":"\u003cstring>","position":123}],"css":"\u003cstring>"}],"themes":{"light":{"background":"\u003cstring>","surface":"\u003cstring>","text":"\u003cstring>","muted":"\u003cstring>","border":"\u003cstring>","accent":"\u003cstring>","contrast":123},"dark":{"background":"\u003cstring>","surface":"\u003cstring>","text":"\u003cstring>","muted":"\u003cstring>","border":"\u003cstring>","accent":"\u003cstring>","contrast":123}}}},"code":"crawl_queued","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"675736be-674f-4610-99af-64acdeebeec5":{"description":"The request body is malformed: `identifiers` is missing, empty or longer than 100, an item is neither a string nor a `{ type, value }` object, or the body has a property the API does not take. `message` names the problem. Nothing is charged.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"081c6fc1-94a4-4ebd-8442-bb16bca96b69":{"description":"No API key was sent, or the `Authorization` header is malformed.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"b0f20eb2-be82-497b-aae6-1d2420cb8117":{"description":"The API key is unknown or revoked, or your organization has no API credits. With `x-bf-error: paid_plan_required`, your organization is on the free plan and holds no prepaid credits.","headers":{"x-bf-error":{"description":"Why the request was refused.","schema":{"type":"string","enum":["paid_plan_required"]}}},"content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"9b242cc4-416f-4728-bb88-541c7b926359":{"description":"Your organization has fewer API credits left than this request could use. `required` is the number of identifiers that could be charged. `remaining` is what is left. Send fewer identifiers, or add credits. Nothing is charged. The same status is returned when the request throughput limit is exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not enough API credits remain for this batch.","uniqueKey":"message","typeLabel":"string"},"quota":{"type":"integer","uniqueKey":"quota","typeLabel":"integer"},"used":{"type":"integer","uniqueKey":"used","typeLabel":"integer"},"remaining":{"type":"integer","uniqueKey":"remaining","typeLabel":"integer"},"required":{"type":"integer","uniqueKey":"required","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Not enough API credits remain for this batch.","quota":123,"used":123,"remaining":123,"required":123}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"317b2c2d-1ce8-494a-a637-3e862f7584fe":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"063de55c-2dbd-42fb-8380-d7a70325c243":{"url":"https://api.brandfetch.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"brandfetch-d7fb5329","siteName":"Brandfetch","title":"Brand API batch - Brandfetch","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T13:56:05.355Z","originalFileLocation":"reference/brand-api-batch.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way GET /v2/brands/{identifier} answers it. One difference: 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. Each identifier answered 200 uses one API credit. Every other result is free, 404 included. An identifier repeated in one request is charged once. Available on paid plans and with prepaid credits. Authenticate with an API key sent as Authorization: Bearer .\">\u003cmeta data-mint-head name=\"application-name\" content=\"Brandfetch\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Brand API batch - Brandfetch\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way GET /v2/brands/{identifier} answers it. One difference: 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. Each identifier answered 200 uses one API credit. Every other result is free, 404 included. An identifier repeated in one request is charged once. Available on paid plans and with prepaid credits. Authenticate with an API key sent as Authorization: Bearer .\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Brandfetch\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.brandfetch.com/reference/brand-api-batch\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://developers.brandfetch.com/og_docs.webp\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Brand API batch - Brandfetch\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way GET /v2/brands/{identifier} answers it. One difference: 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. Each identifier answered 200 uses one API credit. Every other result is free, 404 included. An identifier repeated in one request is charged once. Available on paid plans and with prepaid credits. Authenticate with an API key sent as Authorization: Bearer .\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://developers.brandfetch.com/og_docs.webp\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/brandfetch-d7fb5329/D3XFukFFOrKC-_RS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Brandfetch\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0084FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.brandfetch.com/reference/brand-api-batch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/brand-api-batch.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.brandfetch.com/#organization\",\"name\":\"Brandfetch\",\"url\":\"https://docs.brandfetch.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/brandfetch-d7fb5329/-v6e41qD3Fxu16r-/logo/light.svg?fit=max\u0026auto=format\u0026n=-v6e41qD3Fxu16r-\u0026q=85\u0026s=4f8ea49e20e0d743c9a7754b14f01924\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.brandfetch.com#website\",\"name\":\"Brandfetch\",\"url\":\"https://docs.brandfetch.com\",\"publisher\":{\"@id\":\"https://docs.brandfetch.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.brandfetch.com/reference/brand-api-batch#webpage\",\"url\":\"https://docs.brandfetch.com/reference/brand-api-batch\",\"name\":\"Brand API batch\",\"description\":\"Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way GET /v2/brands/{identifier} answers it. One difference: 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. Each identifier answered 200 uses one API credit. Every other result is free, 404 included. An identifier repeated in one request is charged once. Available on paid plans and with prepaid credits. Authenticate with an API key sent as Authorization: Bearer .\",\"dateModified\":\"2026-10-08T13:56:05.355Z\",\"isPartOf\":{\"@id\":\"https://docs.brandfetch.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.brandfetch.com/reference/brand-api-batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.brandfetch.com/reference/brand-api-batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Brand API\",\"item\":\"https://docs.brandfetch.com/reference/brand-api-domain\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Brand API batch\",\"item\":\"https://docs.brandfetch.com/reference/brand-api-batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.brandfetch.com/reference/brand-api-batch#apireference\",\"headline\":\"Brand API batch\",\"name\":\"Brand API batch\",\"description\":\"Send up to 100 identifiers. Get one result per identifier, in the order you sent them. Each identifier is answered the way GET /v2/brands/{identifier} answers it. One difference: 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. Each identifier answered 200 uses one API credit. Every other result is free, 404 included. An identifier repeated in one request is charged once. Available on paid plans and with prepaid credits. Authenticate with an API key sent as Authorization: Bearer .\",\"url\":\"https://docs.brandfetch.com/reference/brand-api-batch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.brandfetch.com/reference/brand-api-batch#webpage\"},\"image\":\"https://developers.brandfetch.com/og_docs.webp\",\"dateModified\":\"2026-10-08T13:56:05.355Z\",\"publisher\":{\"@id\":\"https://docs.brandfetch.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.brandfetch.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Brandfetch\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Brandfetch","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/get-started"}]},{"tab":"API References","groups":[{"group":"Brand API","pages":[{"title":"Brand API by domain","sidebarTitle":"/v2/brands/domain/{domain}","openapi":"GET /v2/brands/domain/{domain}","href":"/reference/brand-api-domain"},{"title":"Brand API by ticker","sidebarTitle":"/v2/brands/ticker/{ticker}","openapi":"GET /v2/brands/ticker/{ticker}","href":"/reference/brand-api-ticker"},{"title":"Brand API by ISIN","sidebarTitle":"/v2/brands/isin/{isin}","openapi":"GET /v2/brands/isin/{isin}","href":"/reference/brand-api-isin"},{"title":"Brand API by crypto","sidebarTitle":"/v2/brands/crypto/{symbol}","openapi":"GET /v2/brands/crypto/{symbol}","href":"/reference/brand-api-crypto"},{"title":"Brand API (auto-detect)","sidebarTitle":"/v2/brands/{identifier}","openapi":"GET /v2/brands/{identifier}","description":"Get brand data using a Domain, Website URL, Email address, Brand ID, ISIN, Stock/ETF ticker, or Crypto symbol. Authenticate with an API key sent as `Authorization: Bearer \u003ckey>`, or pay for the single request with x402 or MPP: https://docs.brandfetch.com/agents/pay-per-request.","href":"/reference/brand-api"},{"title":"Brand API batch","sidebarTitle":"/v2/brands/batch","openapi":"POST /v2/brands/batch","href":"/reference/brand-api-batch"},{"title":"Brand API prefetch (HEAD)","sidebarTitle":"/v2/brands/{identifier}","openapi":"HEAD /v2/brands/{identifier}","description":null,"href":"/reference/brand-api-prefetch"},{"title":"Brand API prefetch by domain (HEAD)","sidebarTitle":"/v2/brands/domain/{domain}","openapi":"HEAD /v2/brands/domain/{domain}","href":"/reference/brand-api-prefetch-domain"}]},{"group":"Brand Context API","pages":[{"title":"Brand Context API","sidebarTitle":"/v2/context/{domain}","openapi":"GET /v2/context/{domain}","href":"/reference/brand-context-api"}]},{"group":"Brand Search API","pages":[{"title":"Brand Search API","sidebarTitle":"/v2/search/{name}","openapi":"GET /v2/search/{name}?c={clientId}","href":"/reference/brand-search-api"}]},{"group":"Transaction API","pages":[{"title":"Transaction API","sidebarTitle":"/v2/brands/transaction","openapi":"POST /v2/brands/transaction","href":"/reference/transaction-api"}]},{"group":"Viewer API","pages":[{"title":"Viewer API","sidebarTitle":"/v2/viewer","openapi":"GET /v2/viewer","href":"/reference/viewer-api"}]},{"group":"Agent access","pages":[{"title":"Agent access offer","sidebarTitle":"GET /v2/agents/access","openapi":"GET /v2/agents/access","href":"/reference/agents-access-offer"},{"title":"Buy agent access","sidebarTitle":"POST /v2/agents/access","openapi":"POST /v2/agents/access","href":"/reference/agents-access-purchase"}]}]},{"tab":"Resources","pages":[{"title":"Resources","href":"/integrations/overview"}]},{"tab":"Use cases","pages":[{"title":"Use cases","href":"/use-cases/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/overview"}]}]},"title":"Brand API batch - Brandfetch","buildId":"dpl_48qhjNLiu9iJQQSZJz9Fa2ihBbPH","deploymentId":"dpl_48qhjNLiu9iJQQSZJz9Fa2ihBbPH","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rBlzXElK.js","utils-AjnlCZis.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-swvqTHUt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CG9fqVU0.js","snippetPresets-CQaUsst6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DAdT3l54.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B1x8JMQI.js","shallow-D3oUTT8_.js","getApiPlaygroundDisplay-CXVJ98Sz.js","CodeSnippet-HbTSvyGs.js","CodeSnippets-DvgXFP0T.js","Page-C2raW8UD.js","getPastedJson-CfDE0eLj.js","icon-DBPqa2DN.js","MethodPill-86CHHFOO.js","DuplicateIcon-B5BXvyBd.js","createIcon-C_r05QJX.js","DynamicMarkdown-Cp6hhEk1.js","SectionHeading-RZjzOLoo.js","axios-vUo_bRtp.js","Markdown-B0YOyiNO.js","clsx-Q3eNRTcf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-tb1XVL5i.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9O1lyZBL.js"]}