Clair API quickstart

Every Clair API uses one host and one key. Create the key in the dashboard and send it as Authorization: Bearer YOUR_KEY. Paid plans are per API. Full header and error reference: Authentication.

1. Get a key

Open clair.im/dashboard and create an account.
Open the API you want and start its free tier: 200 requests a month, no card. Each API needs its own subscription.
Create a key under API keys and copy it once.

API	Paths	Requests
Google Search	`GET /v1/google-search`	1 / page
Google Maps	`GET /v1/google-maps/search` and `/v1/google-maps/place`	1 / page
Google News	`GET /v1/google-news`	1 / page
Reuters	`GET /v1/reuters/search` and `/v1/reuters/article`	1 / page
Bloomberg	`GET /v1/bloomberg/search` and `/v1/bloomberg/article`	1 / page
Associated Press	`GET /v1/ap/search` and `/v1/ap/article`	1 / page
Glassdoor	`GET /v1/glassdoor/jobs`, `/v1/glassdoor/job`, `/v1/glassdoor/companies`, `/v1/glassdoor/company`, `/v1/glassdoor/salaries`	1 / page
Indeed	`GET /v1/indeed/jobs` and `/v1/indeed/job`	1 / page
Greenhouse	`GET /v1/greenhouse/jobs` and `/v1/greenhouse/job`	1 / page
Amazon	`GET /v1/amazon/search`, `/v1/amazon/product`, `/v1/amazon/reviews`, `/v1/amazon/offers`, `/v1/amazon/lookup`, `/v1/amazon/seller`, `/v1/amazon/seller-products`, `/v1/amazon/bestsellers`, `/v1/amazon/categories`	1 / page
Crunchbase	`GET /v1/crunchbase/organization` and `/v1/crunchbase/person`	1 / page
Website Contacts	`GET /v1/contacts`	1 / page
Trustpilot Reviews	`GET /v1/trustpilot/reviews`, `/v1/trustpilot/search`, `/v1/trustpilot/categories`, `/v1/trustpilot/review`	1 / page
Product Hunt	`GET /v1/producthunt/launches` and `GET /v1/producthunt/product`	1 / page

Publisher article scrapes (Reuters, Bloomberg, Associated Press) are in the API catalog.

2. Make your first call

Google Search
Contacts

Live organic Google Search, 10 hits per page:

cURL

curl -G https://api.clair.im/v1/google-search \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "q=inflation" \
  --data-urlencode "country=us" \
  --data-urlencode "page=1"

Google Search API

Organic hits, page pagination, language, and country.

Public emails, phones, and social URLs from a company domain:

cURL

curl -G https://api.clair.im/v1/contacts \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "domain=stripe.com"

Website Contacts API

Homepage plus linked same-origin pages. Default five pages. One request.

3. Read the errors

Mounted endpoints return a stable machine-readable code you can branch on and human detail you should not parse. Typical envelope:

{ "error": "bad_request", "detail": "q is required" }

401 means the bearer token is missing or invalid. 403 with not_subscribed means the account has no subscription to that API yet. 429 with quota_exceeded means the API’s requests for the period are used up; rate_limit_exceeded means the account rate limit was hit, so wait Retry-After seconds.

Every call is one request, whichever API it goes to. Each page is its own request. A call that fails with a 5xx is not charged.

​1. Get a key

​2. Make your first call

Google Search API

Website Contacts API

​3. Read the errors

1. Get a key

2. Make your first call

3. Read the errors