Brand enrichment
Use Brand endpoints to turn brand enrichment into repeatable API requests with documented inputs and JSON responses.
Use a Brand Data API to turn any domain into a normalized brand profile — title, description, slogan, brand colors, logos and icons, social profiles, footer links, and schema.org organization data — as structured JSON for enrichment, branding, and research workflows.
Use a Brand Data API to extract a normalized brand profile by domain — title, colors, logos, socials, links, and schema.org org data — as structured JSON.
Endpoint families
1
Documented params
6
Examples
1
Live catalog snapshot
Active endpoints
1
Methods
GET
Required params
2
Schema refs
1
{
"platform": "Brand",
"endpoint": "brand-retrieve",
"method": "GET",
"path": "/brand/retrieve",
"auth": "apiKey"
}Related use cases
Use cases
Use a Brand Data API to extract a normalized brand profile by domain — title, colors, logos, socials, links, and schema.org org data — as structured JSON.
Use Brand endpoints to turn brand enrichment into repeatable API requests with documented inputs and JSON responses.
Use Brand endpoints to turn logo & color extraction into repeatable API requests with documented inputs and JSON responses.
Use Brand endpoints to turn company data enrichment into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Brand endpoint catalog — 1 endpoints, 6 documented request parameters, and 1 published response schemas — the same catalog Docs and Playground run against.
1 documented Brand endpoints, all in the Retrieve family.
6 request parameters are documented across those Brand endpoints, 2 of them required — the full input contract is public before you write any integration code.
1 of the 1 Brand endpoints ship a recorded example response, and 1 carry a documented response schema — you can code against the real JSON before the first request.
Brand endpoints document their error responses (400, 404, 408, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
1 hosted MCP tool backs the Brand endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/brand/retrieve
Endpoint catalog
/brand/retrieveFetches a domain's homepage and Web App Manifest and extracts a normalized brand profile (title, description, brand colors normalized to hex, logos and icons ranked best-first, backdrops, socials, links, and any schema.org organization data). Enrichment-only fields that are not present in the page markup are returned as null.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"domain":"context.dev","title":"Context","description":"Brand intelligence for the modern web.","slogan":"Know every brand.","colors":[{"hex":"#0b0b0b"}],"logos":[{"url":"https://cdn.context.dev/logo.png","type":"logo"},{"url":"https://context.dev/favicon.ico","resolution":{"width":32,"height":32,"aspect_ratio":1},"type":"icon"}],"backdrops":[{"url":"https://cdn.context.dev/og.png"}],"socials":[{"type":"x","url":"https://x.com/context"},{"type":"linkedin","url":"https://www.linkedin.com/company/context"}],"address":{"street":"1 Market St","city":"San Francisco","country":"US","state_province":"CA","postal_code":"94105"},"stock":{"ticker":"CTXT","exchange":"NASDAQ"},"is_nsfw":false,"email":"hello@context.dev","phone":"+1-555-0100","links":{"careers":"https://context.dev/careers","privacy":"https://context.dev/legal/privacy","terms":"https://context.dev/terms","contact":"https://context.dev/contact","blog":"https://context.dev/blog","pricing":"https://context.dev/pricing"},"primary_language":"en","source":{"type":"html","url":"https://context.dev"}}} ```
MCP tool brand_retrieve
Related APIs
Business & Market Intelligence
Turn public GitHub ecosystem signals into structured data for developer-market research, open-source intelligence, recruiting, and AI-agent workflows.
Business & Market Intelligence
Collect public TrustMRR startup marketplace and leaderboard data as normalized JSON for startup research, SaaS discovery, and market intelligence workflows.
Business & Market Intelligence
Add website and competitive intelligence signals from SimilarWeb to research pipelines.
How to scrape Brand
Brand data — logo, colors, description, social profiles — is scattered across a company's homepage markup, its Web App Manifest, and its schema.org metadata. The Brand Data API collapses that into one call: pass a domain, get a normalized brand profile.
The endpoint takes a domain and fetches that site's homepage and Web App Manifest.
You get title, description, slogan, brand colors normalized to hex, logos and icons ranked best-first, backdrops, social profiles, footer links, and any schema.org organization data.
Enrichment-only fields that are not present in the page markup come back as null rather than guessed, so a missing logo is a real signal and not a silent failure.
force_language, maxSpeed, maxAgeMs, and timeoutMS control the language, how aggressively the page is fetched, how stale a cached result may be, and when to give up.
FAQ
Title, description, slogan, brand colors normalized to hex, logos and icons ranked best-first, backdrops, social profiles, footer links, and any schema.org organization data — extracted from the homepage and the Web App Manifest in a single call.
The field comes back null. Enrichment-only fields absent from the page markup are returned as null rather than inferred, so you can tell a brand with no manifest icon apart from a call that failed to look.
Yes, and that is the common use. One call per domain returns a consistent profile shape, so a list of company domains becomes a table of names, descriptions, logos, colors, and social links without per-site parsing.