Quickstart
From signup to first successful API call in under 90 seconds.
This guide takes you from a fresh signup to your first 200 response in under
90 seconds. By the time you finish reading, you'll have a real brand pack for
stripe.com printed to your terminal — colours, fonts, logos, and design
language, all in one JSON document.
Want to kick the tyres without signing up? Try the live demo on the homepage — paste any URL and watch the pipeline run.
Three steps
Sign up free
Head to brandrna.com/signup. No credit card required. The free tier gives you 100 API calls per month — plenty for prototyping a personalisation flow or wiring up an MCP-aware agent.
Copy your API key
When you sign in for the first time, a key is auto-minted for you. Open app.brandrna.com/api-keys and click Copy on the masked-prefix row at the top of the table.
The plaintext key is only shown once — if you miss it, just rotate or mint a
new one. Keys look like bd_xxx (32+ chars). Treat them like passwords.
Run this curl
Replace bd_YOUR_KEY_HERE with the value you copied in Step 2:
curl -H "Authorization: Bearer bd_YOUR_KEY_HERE" \
https://api.brandrna.com/api/v1/pack/stripe.comYou should see a 200 OK and a JSON body within a second or two. Stripe is
in the cache — most well-known domains return instantly at $0 cost.
What you get back
The response is a consolidated brand pack — every visual identity signal we extracted, in one document:
{
"brand": "Stripe",
"domain": "stripe.com",
"colors": {
"primary": "#635BFF",
"secondary": "#0A2540",
"accent": "#00D4FF",
"background": "#FFFFFF",
"text": "#0A2540",
"palette": ["#635BFF", "#0A2540", "#00D4FF", "#F6F9FC"]
},
"fonts": [
{ "family": "sohne-var", "role": "primary" },
{ "family": "Camphor", "role": "secondary" }
],
"logos": [
{
"url": "https://api.brandrna.com/api/v1/assets/logos/stripe.com/canonical.svg",
"role": "wordmark",
"variants": ["light", "dark", "transparent"]
}
],
"voice": {
"tone": "confident",
"archetype": "Sage",
"descriptors": ["technical", "trustworthy", "modern"]
},
"metadata": {
"cached": true,
"extracted_at": "2026-05-08T14:22:11Z",
"total_cost_usd": 0
}
}The full schema is in the API reference. For a step-by-step walkthrough of how to use this in production, jump to Personalize a landing page.
Try your own URL
Swap stripe.com for any URL you care about:
curl -H "Authorization: Bearer bd_YOUR_KEY_HERE" \
https://api.brandrna.com/api/v1/pack/figma.comFamous brands return instantly from cache (free). Novel URLs trigger a fresh
extraction (~5–15s, counts toward your monthly quota). If a URL has never
been seen before, the response includes "metadata.cached": false.
The cache TTL is 24 hours. After that, we re-extract on the next request. This keeps brand packs fresh for sites that rebrand or redesign.