Retrieve Brand by Domain

Get comprehensive brand data from any domain — logos, colors, fonts, social links, industry, and more.

Endpoint: GET /v1/brand/retrieve Credits: 5 per request (0 if cached)

Parameters

Parameter	Type	Required	Description
`domain`	string	Yes	Domain to look up (e.g., `stripe.com`)
`refresh`	boolean	No	Force fresh fetch, bypassing cache (default: false)
`fields`	string	No	Comma-separated list of fields to return

Response Schema

{
  "success": true,
  "data": {
    "name": "Stripe",
    "domain": "stripe.com",
    "description": "Financial infrastructure for the internet.",
    "logos": [
      {
        "url": "https://cdn.orsa.dev/logos/stripe-light.svg",
        "type": "svg",
        "theme": "light",
        "width": 120,
        "height": 40
      }
    ],
    "colors": ["#635BFF", "#0A2540", "#00D4AA"],
    "fonts": ["Inter", "system-ui", "-apple-system"],
    "industry": "Financial Technology",
    "naics_code": "522320",
    "socials": {
      "twitter": "https://twitter.com/stripe",
      "linkedin": "https://linkedin.com/company/stripe",
      "github": "https://github.com/stripe",
      "facebook": null
    },
    "meta": {
      "title": "Stripe | Payment Processing Platform",
      "description": "Online payment processing for internet businesses.",
      "favicon": "https://stripe.com/favicon.ico",
      "og_image": "https://stripe.com/img/v3/home/twitter.png"
    },
    "page_links": {
      "pricing": "https://stripe.com/pricing",
      "about": "https://stripe.com/about",
      "careers": "https://stripe.com/jobs"
    },
    "cached": false,
    "fetched_at": "2024-12-15T10:30:00Z"
  },
  "credits_used": 5
}

Code Examples

cURL

curl -X GET "https://api.orsa.dev/v1/brand/retrieve?domain=stripe.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

TypeScript

const brand = await client.brand.retrieve({
  domain: 'stripe.com',
});
 
console.log(brand.name);       // "Stripe"
console.log(brand.colors);     // ["#635BFF", "#0A2540", "#00D4AA"]
console.log(brand.logos[0].url);
console.log(brand.socials.twitter);

Python

brand = client.brand.retrieve(domain="stripe.com")
 
print(brand.name)          # "Stripe"
print(brand.colors)        # ["#635BFF", "#0A2540", "#00D4AA"]
print(brand.logos[0].url)
print(brand.socials.twitter)

Notes

Cached responses return instantly (~250ms) and cost 0 credits. Cache TTL is 24 hours.
Use refresh=true to force a fresh browser fetch (useful if a company rebranded).
The fields parameter accepts: name, logos, colors, fonts, socials, industry, meta, page_links.

Crawl Website Retrieve by Name