> ## Documentation index > Fetch the complete documentation index at: https://rankfield.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get a company's brand > Get a company's name, description, logos, icons, colours, fonts, social profiles and published contact details from its domain. `GET https://rankfield.dev/v1/brand?domain={domain}` ```bash cURL curl 'https://rankfield.dev/v1/brand?domain=rankfield.dev' \ -H 'Authorization: Bearer YOUR_API_KEY' ``` ```python Python import requests response = requests.get( "https://rankfield.dev/v1/brand?domain=rankfield.dev", headers={"Authorization": "Bearer YOUR_API_KEY"}, ) print(response.json()) ``` ```javascript JavaScript const response = await fetch("https://rankfield.dev/v1/brand?domain=rankfield.dev", { headers: { "Authorization": "Bearer YOUR_API_KEY", }, }); console.log(await response.json()); ``` ```json 200 { "domain": "rankfield.dev", "finalUrl": "https://rankfield.dev/", "status": 200, "blocked": null, "name": { "value": "Rankfield", "source": "title" }, "description": { "value": "Get a key without signing up and query Site Strength and referring domain metrics.", "source": "meta description" }, "logos": [ { "url": "data:image/svg+xml,%3Csvg%20class=%22brand-mark%22%20aria-hidden=%22true%22%20xmlns=%22http://www.w3.org/2000/svg%22%20viewBox=%220%200%2064%2064%22%3E%3Crect%20x=%228%22%20y=%2231%22%20width=%2212%22%20height=%2226%22%20rx=%224%22%20fill=%22%23ff766a%22%20stroke=%22%23252238%22%20stroke-width=%222.5%22%3E%3C/rect%3E%3Crect%20x=%2226%22%20y=%229%22%20width=%2212%22%20height=%2248%22%20rx=%224%22%20fill=%22%238067ed%22%20stroke=%22%23252238%22%20stroke-width=%222.5%22%3E%3C/rect%3E%3Crect%20x=%2244%22%20y=%2221%22%20width=%2212%22%20height=%2236%22%20rx=%224%22%20fill=%22%236edfc5%22%20stroke=%22%23252238%22%20stroke-width=%222.5%22%3E%3C/rect%3E%3C/svg%3E", "source": "header inline ` or `the style engine failed on this page`. `null` when the roles are there. | | `fonts` | array | `{family, source, uses}`: Google Fonts, `@font-face`, Adobe Fonts, then fonts the CSS asks for. | | `typography` | object \| null | The site's base typography, read from its CSS as a 1280 × 800 desktop window applies it: `rootFontSize`, and for `body`, `h1`–`h6`, `button` and `link` the `family`, `size`, `weight`, `lineHeight` and `letterSpacing`. Each value has `value` (in force, `var()` resolved, or `null`), `declared` (as written), `px` with its `basis` for lengths, `number` for weight, `primary` and `generic` for families, its `source` stylesheet (or `style element`), `selector`, `media`, `inherited` (`body` or `html`) and, when `null`, a `reason` naming the browser default. `null` on a blocked or error page. | | `social` | array | `{network, url, source}` from schema.org `sameAs`, then links to known social sites. Never visited. | | `contact` | object | `{source, email, telephone, address, contactPoints}`, only from the site's own schema.org Organization or LocalBusiness data. | | `language` | object | The homepage's language. | | `fetches` | array | Each request made: `{url, purpose, status, bytes, error}`. | | `screenshot` | object | With `screenshot`: `{format: "webp", kind, viewport, bytes, data}`, the image in base64. | | `cached`, `ageSeconds` | boolean, integer | Whether this answer came from our store, and how old it is. | Colour roles are computed on the page as fetched, without JavaScript: a page whose buttons get their colours from script gets the colours of its static HTML and CSS. Names and descriptions never carry an email address or phone number: where the site's text has one, it shows as "…". Contact details only appear in `contact`. `typography` reads the site's base rules (`body`, `h1`, `h1, .h1`, `button` and `.btn`, `a`), not each widget's styling. Nothing is guessed: a value the CSS does not declare is `null`, with a `reason`. ## How we fetch We fetch as `Rankfield-User` (`Mozilla/5.0 (compatible; Rankfield-User/1.0; +https://rankfield.dev/bot)`), as plain HTML without running JavaScript, unless you ask for a rendered page or a screenshot. - **robots.txt:** obeyed on every request and redirect, following the rules for `Rankfield-User`, or for `RankfieldBot` when the file has none for it, or `*` when it has neither. Social sites and font services are named from their links, never fetched. - **Firewalls:** a challenge, CAPTCHA or block page is reported in the answer, never worked around and never retried. - **Never:** cookies, logins, proxies or other bots' names. JavaScript runs only when you ask for it. - **Excluded sites:** Reddit, LinkedIn, Facebook, Instagram, X/Twitter and TikTok (subdomains included), Google search result pages, and sites whose owners asked us are never fetched. - **Pace:** each website is fetched gently, shared by all customers, slower when its robots.txt sets a `Crawl-delay` or after a slow answer. Many URLs on one site go at that site's pace. Repeat calls to the same website within about a minute can wait their turn for that site's slot. If the wait runs past the call's time limit (20 seconds by default), the call ends with `504` `timeout` and `details.reason` `sitePace`. It doesn't count as usage: retry after `Retry-After`, or allow a longer `timeout`. More: [Rankfield crawlers](/bot). ## Errors Errors are `{"error": {"code", "message", "details"}}`. Branch on `code`; `message` is for people. | Status | Code | When | |---|---|---| | 400 | `invalid_input` | A parameter is missing, unknown or malformed. | | 401 | `unauthorized` | No valid API key. | | 403 | `robots_disallowed` | robots.txt disallows Rankfield-User for the homepage (a server error counts as no); `details` has the rule and line. | | 403 | `site_excluded` | The site is on the exclusion list. | | 403 | `blocked` | The website's bot protection refused us. Reported at once and never worked around; `details` says which protection. Not counted as usage. | | 415 | `unsupported_content_type` | The homepage answered 2xx but isn't HTML. | | 422 | `address_not_public` | The host resolves to a private or internal address. | | 429 | `busy` | Our fetch capacity is busy: the call was refused at once, waited 4 seconds without a turn, or its time limit ran out while it waited (then `details.reason` is `capacity`). Not counted as usage. Retry after `Retry-After` seconds. | | 500 | `internal` | Our bug. Retry. | | 502 | `fetch_failed` | The site could not be reached: DNS failed, neither https nor http connected, or more than 5 redirects. | | 503 | `unavailable` | The service is restarting or briefly unavailable. Retry after `Retry-After`. (A full fetch capacity answers `429` `busy`.) | | 504 | `timeout` | The website didn't answer within the call's time limit. When `details.reason` is `sitePace`, the call waited its turn for this website instead, which we fetch gently, shared by all customers: retry after `Retry-After`, or allow a longer `timeout`. | Only answered calls and the `502` and website-side `504` errors count as usage; refusals, our own errors (`500`, `503`), `429` `busy` and a `504` with `details.reason` `sitePace` don't. ## Limits No per-key limits. When the server is busy you get `429` `busy` with `Retry-After`. Waiting calls are served in turn across keys, so a key with a few calls is never stuck behind one with thousands. ## MCP On the [MCP server](/docs/agents/mcp-server), the tool for this is `brand_profile`.