Skip to main content
Use type: "by_domain" when you know the company’s website. A URL such as https://www.stripe.com/pricing is normalized to stripe.com.

​
Request

Send this body to POST /brand/retrieve. See the Quickstart for authentication and SDK setup.
Read the profile as shown in Brand overview.

​
Freshness and cold domains

maxAgeMs defaults to three months. Set 0 to refresh or accept a larger window for infrequently changing profiles. An uncached domain with timeoutOpts.behavior: "fail" and a deadline below 10,000 ms returns 422 COLD_DOMAIN_TIMEOUT_TOO_LOW. Use a 60,000 ms budget, allow partial results, or prefetch before the lookup. Keep your client timeout longer than the API deadline. A background refresh can use:
Inspect partial and handle website-access errors without retrying indefinitely. See troubleshooting.