Clair API quickstart

Every Clair API shares one host, one key, and one credit wallet. Create the key in the dashboard and send it as Authorization: Bearer YOUR_KEY. Full header, credit, and error reference: Authentication.

1. Get a key

Open clair.im/dashboard and create an account.
New accounts receive 250 free credits.
Create a key under API keys and copy it once.

API	Path	Credits
Google Search	`GET /v1/search?engine=google_search`	5 / page
News	`GET /v1/news`	1
Jobs	`GET /v1/jobs`	1
Website Contacts	`GET /v1/contacts`	10
Trustpilot Reviews	`GET /v1/reviews`	8
Product Hunt	`GET /v1/launches`	8

Live Google News, publisher article scrapes, Glassdoor, and ATS-pinned job indexes are listed in the dashboard catalog.

2. Make your first call

News
Jobs
Google Search
Contacts

Search titles and cleaned article content with phrases, alternatives, and exclusions:

cURL

curl -G https://api.clair.im/v1/news \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode 'q="central bank" OR inflation -sports' \
  --data-urlencode "sort_by=published_at" \
  --data-urlencode "limit=25"

Full news quickstart

Relevance ordering, newest-first corpus walks, source filters, revisions, content states, and cursor pagination.

Search jobs already normalized across applicant tracking systems:

cURL

curl -G https://api.clair.im/v1/jobs \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "q=machine learning" \
  --data-urlencode "seniority=intern" \
  --data-urlencode "workplace_type=remote" \
  --data-urlencode "limit=25"

Full jobs quickstart

Cursor pagination, compensation and skills filters, provenance, and index freshness.

Live organic Google Search, 10 hits per page:

cURL

curl -G https://api.clair.im/v1/search \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "engine=google_search" \
  --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 one same-origin contact page. 10 credits.

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. 429 means the wallet is empty or the account rate limit was exceeded.

Indexed News and Jobs use 1 credit. Live Google Search and Google News use 5. Article and listing scrapes (Bloomberg, AP, Reuters, Glassdoor, Trustpilot, Product Hunt) use 8. Website contacts use 10.

​1. Get a key

​2. Make your first call

Full news quickstart

Full jobs quickstart

Google Search API

Website Contacts API

​3. Read the errors

1. Get a key

2. Make your first call

3. Read the errors