{"uid":"cap_LHT5KFaadH78FQPtjA0ES","slug":"brand-data-retrieval-by-company-name-0920fc06","name":"Brand Data Retrieval by Company Name","description":"Retrieve brand information using a company name. This endpoint searches for the company by name and returns its brand data.","url":"https://x402.orthogonal.com/brand-dev/v1/brand/retrieve-by-name","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"name":{"type":"string","example":"Apple Inc","description":"Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft Corporation'). Must be 3-30 characters."},"maxSpeed":{"type":"boolean","description":"Optional parameter to optimize the API call for maximum speed. When set to true, the API will skip time-consuming operations for faster response at the cost of less comprehensive data."},"timeoutMS":{"type":"integer","description":"Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes)."},"force_language":{"type":"string","description":"Optional parameter to force the language of the retrieved brand data."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U32aq9qBwNlE3MudePBjk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up and returns brand information for a company given its name as a search query.","exampleAgentPrompt":"Can you pull up the brand data for 'Apple Inc' — I need their brand profile information retrieved by company name?","exampleUseCases":[{"title":"Competitive brand research dashboard","prompt":"I'm building a competitor analysis tool — can you fetch the brand data for 'Tesla Inc' so I can compare it against our own brand assets?"},{"title":"Automated brand enrichment pipeline","prompt":"We have a list of company names in our CRM and I need to enrich each record with brand info — start by retrieving the brand data for 'Microsoft Corporation'."},{"title":"Marketing agency client onboarding","prompt":"I'm onboarding a new client and want to pull up the existing brand profile for 'Spotify AB' to see what brand data is already publicly available before our kick-off call."}],"resultDescription":"Returns structured brand data for the requested company, including brand identity details such as name, logo references, colors, and other brand metadata associated with the company found by the name search.","failureModes":["Company name not found — returns empty result or 404 if no match exists","Name too short or too long (must be 3–30 characters) — returns validation error","Request timeout if timeoutMS exceeded — returns 408 status","Ambiguous company name matching multiple entities — may return unexpected brand","Service unavailable or payment failure — returns 402 or 5xx error"],"whenToPreferThis":"Use this endpoint when you have a company name and need to retrieve its brand data programmatically without requiring a domain or URL. Prefer this over domain-based brand lookups when only the company name is known. It's well-suited for CRM enrichment, competitive research, and marketing workflows where company names are the primary identifier.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:02:26.195Z","isFirstParty":false}