Brandcurl API quickstart

This reference becomes interactive when JavaScript loads. The complete compact contract is also available as plain Markdown, with a contract-complete JSON response.

Authenticate

Create a key from Dashboard → API keys, store it server-side as BRANDCURL_API_KEY, and send Authorization: Bearer bc_live_….

curl -H "Authorization: Bearer $BRANDCURL_API_KEY" \
  https://brandcurl.com/v1/brands/stripe.com

Cache paid reads

Store each successful response body with its ETag. Send that value in If-None-Match next time; on 304, reuse the stored body. A 304 is not charged. Inspect X-Cache, RateLimit-*, and X-Balance-Remaining.

Use GET /v1/brands/{domain} for normal brand retrieval. Refresh is an explicit paid write; context is for materialized messaging intelligence; enrichment is for separate firmographics. See the current price sheet.