Quickstart

This guide will get you all set up and ready to use the Brandsearch API. We'll cover how to get your API key and make your first request.

Before you can make requests to the Brandsearch API, you will need to grab your API key from your Brandsearch dashboard. You'll find it under API settings.

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.

GET

/v1/brands

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

Read the docs for the Brands endpoint

Look up a brand by domain

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

GET

/v1/brands/by-url/nike.com

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: