Retrieve Brand by Name

Look up brand data using a company name. Uses fuzzy matching to find the closest match.

Endpoint: GET /v1/brand/retrieve-by-name Credits: 10 per request

Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Company or brand name (e.g., `Stripe`, `Linear`)

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"],
    "industry": "Financial Technology",
    "socials": {
      "twitter": "https://twitter.com/stripe",
      "linkedin": "https://linkedin.com/company/stripe",
      "github": "https://github.com/stripe"
    },
    "meta": {
      "title": "Stripe | Payment Processing Platform",
      "favicon": "https://stripe.com/favicon.ico"
    }
  },
  "credits_used": 10,
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Code Examples

cURL

curl -X GET "https://api.orsa.dev/v1/brand/retrieve-by-name?name=Stripe" \
  -H "Authorization: Bearer YOUR_API_KEY"

TypeScript

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

Python

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

Error Codes

Code	Status	Description
`INPUT_VALIDATION_ERROR`	400	Missing or empty name parameter
`UNAUTHORIZED`	401	Missing or invalid API key
`NOT_FOUND`	404	No brand found matching the given name
`RATE_LIMITED`	429	Rate limit exceeded
`USAGE_EXCEEDED`	402	Insufficient credits

Notes

Uses fuzzy matching (trigram similarity) — exact spelling isn't required.
If the brand hasn't been indexed yet, you'll get a 404. Use Retrieve by Domain to trigger extraction for new domains.
Name matching searches both company titles and normalized domain names.
Maximum name length is 500 characters.

Retrieve by Domain Retrieve by Email