API Quickstart

Make your first API call in 60 seconds

This guide gets you from zero to a working API call as fast as possible. You will create an API key, make a request, and see real company data — all in under a minute. For full endpoint documentation, see the API Reference.

Prerequisites

You need a ClearView account on a Starter plan or above (API access is not available on the Free plan). If you do not have an account yet, start with the Getting Started guide.

Create an API key

Go to Settings > API Keys in your dashboard. Click "Create Key", give it a name (e.g., "Dev"), and select "read" permissions. Copy the key — you will not be able to see it again after closing the modal.

Make your first request

Use curl, Postman, or any HTTP client to call the companies endpoint. Replace YOUR_API_KEY with the key you just created.

Try It Now

Copy and paste this into your terminal:

Your first API call

bash

curl -s "https://app.democlearview.com/api/v1/companies?limit=3&sort=score&order=desc" \
  -H "Authorization: Bearer YOUR_API_KEY" | python3 -m json.tool

You should see a JSON response like this:

Response

json

{
  "data": [
    {
      "id": "comp_a1b2c3d4",
      "name": "Acme Corp",
      "domain": "acme.com",
      "industry": "Technology",
      "size": "51-200",
      "employeeCount": 142,
      "leadScore": 87,
      "tier": "hot",
      "lastSeen": "2026-04-10T14:22:00Z",
      "visitorCount": 4
    }
  ],
  "pagination": {
    "total": 47,
    "page": 1,
    "limit": 3
  }
}

Common Next Steps

Resolve a specific company

Look up a company by domain or IP address:

Resolve by domain

bash

curl -s "https://app.democlearview.com/api/v1/resolve?domain=acme.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get contacts for a company

List all identified contacts at a specific company:

List contacts

bash

curl -s "https://app.democlearview.com/api/v1/companies/acme.com/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter hot leads

Get only companies with a lead score of 70+:

Hot leads

bash

curl -s "https://app.democlearview.com/api/v1/companies?tier=hot&sort=score&order=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Using JavaScript/Node.js

Same request using fetch:

fetch-companies.js

javascript

const response = await fetch(
  "https://app.democlearview.com/api/v1/companies?tier=hot&limit=10",
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  }
);
const { data, pagination } = await response.json();
console.log(`Found ${pagination.total} hot leads`);
data.forEach((company) => {
  console.log(`${company.name} (score: ${company.leadScore})`);
});

Using Python

Same request using the requests library:

fetch_companies.py

python

import requests
response = requests.get(
    "https://app.democlearview.com/api/v1/companies",
    params={"tier": "hot", "limit": 10},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = response.json()
print(f"Found {data['pagination']['total']} hot leads")
for company in data["data"]:
    print(f"{company['name']} (score: {company['leadScore']})")

Rate Limits

Endpoint Type	Rate Limit
Read endpoints (GET)	100 requests / minute
Write endpoints (POST/PUT/DELETE)	30 requests / minute

If you exceed the rate limit, the API returns a 429 Too Many Requests response with a Retry-After header indicating how many seconds to wait before retrying.

Next Steps

Now that you have a working API key and can make requests, explore the full API Reference for all available endpoints, or set up Webhooks to receive real-time event notifications.