Developers

Adamlead API

Programmatic, read-only access to the verified contact and company directory. Search contacts and enrich a domain with firmographics — the same masked data the app shows, over a simple JSON API.

Base URL

https://www.adamlead.com/api/v1

Authentication

Create a key in Settings → API (shown once — store it somewhere safe). Pass it as a bearer token on every request:

curl "https://www.adamlead.com/api/v1/contacts?q=marketing" \
  -H "Authorization: Bearer sk_live_your_key_here"

Rate limits

Each key has a per-minute request budget. Every response includes X-RateLimit-Limit and X-RateLimit-Remaining headers; exceeding the budget returns 429 with a Retry-After.

GET /contacts

Search the masked contact directory. Emails are returned masked (e.g. j***@acme.com); the raw address is never exposed by this read-only endpoint. Results are paginated 25 per page.

Query parameters

qKeyword across name, title, and company.

titleMatch a job title (contains).

seniorityComma-separated seniority levels.

departmentComma-separated departments.

industryComma-separated company industries.

employeeRangeComma-separated company size bands.

emailStatusverified, probable, or unverified (comma-separated).

country / state / cityLocation filters.

hasPhone1 to only return contacts with a phone.

sort / dirsort = name | company; dir = asc | desc.

p1-indexed page number.

curl "https://www.adamlead.com/api/v1/contacts?department=Marketing&emailStatus=verified&p=1" \
  -H "Authorization: Bearer sk_live_your_key_here"

Response

{
  "data": [
    {
      "id": "…",
      "full_name": "Sarah Chen",
      "title": "VP of Marketing",
      "seniority": "VP",
      "department": "Marketing",
      "email_masked": "s***@northwind.io",
      "has_email": true,
      "email_status": "verified",
      "email_confidence": 96,
      "location": { "city": "Austin", "state": "TX", "country": "US" },
      "company": {
        "name": "Northwind",
        "domain": "northwind.io",
        "industry": "SaaS",
        "employee_range": "51-200"
      }
    }
  ],
  "pagination": { "page": 1, "page_size": 25, "total": 128, "total_pages": 6 }
}

GET /enrich

Resolve a company domain (or an email's domain) to its firmographics.

Query parameters

domainCompany domain, e.g. acme.com.

emailAlternatively an email — its domain is used.

curl "https://www.adamlead.com/api/v1/enrich?domain=northwind.io" \
  -H "Authorization: Bearer sk_live_your_key_here"

Errors

Errors return a JSON envelope with an HTTP status:

{ "error": { "code": "rate_limited", "message": "Rate limit exceeded. Try again shortly." } }

401Missing, invalid, or revoked API key.

404No record matched (e.g. unknown domain).

429Rate limit exceeded — retry after the delay.

400Missing or malformed parameter.

Ready to start? Create an API key →