Quickstart

There are two ways to use Brandsearch — pick the one that fits how you work.

Use it with your AI assistant

If you just want to ask Claude, ChatGPT, Cursor, or another AI tool about brands and ads, connect Brandsearch over MCP. Sign in once and the AI gets structured tools — no API key to manage, no code to write.

Use it from your own code

If you're building an integration, scraping pipeline, or backend job, call the REST API directly. The rest of this page walks through your first request.

Get your API key

Sign in to app.brandsearch.co, navigate to your API settings, and create a new API key. Your key will start with bsk_ and will only be shown once — make sure to store it securely.

Making your first API request

After getting your API key, you're ready to make your first call. Below, you can see how to send a GET request to the Brands endpoint to list brands.

curl -G https://api.brandsearch.co/v1/brands \
  -H "X-API-Key: bsk_your_api_key" \
  -d page_size=5

Look up a brand by domain

You can look up any brand by its domain name using the /v1/brands/by-url/{url} endpoint.

curl https://api.brandsearch.co/v1/brands/by-url/nike.com \
  -H "X-API-Key: bsk_your_api_key"

Check your quota

Every API response includes quota headers so you can track your usage:

• X-Quota-Daily-Remaining — requests left today
• X-Quota-Monthly-Remaining — requests left this month
• X-Quota-Daily-Limit — your daily limit
• X-Quota-Monthly-Limit — your monthly limit

What's next?

Great, you're now set up and have made your first request. Here are a few links to go further:

• Learn about authentication
• Browse the Brands endpoint
• Get ads for a brand
• Understand rate limits and quotas
• Learn about error handling