Introduction

Welcome to the LeadLeap Data API.

One REST surface. One key. A canonical company directory, a typed-edge entity graph, and an email validator behind a small, stable set of endpoints. Same auth, same key, same response shape across all of them.

Base URL

https://data.leadleap.net

Auth is Authorization: Bearer <your-llk_ext_ key> on every request. The same key works on every endpoint. See Authentication for issuing + rotating keys.

Minimum viable request

curl -H "Authorization: Bearer $LEADLEAP_KEY" \
  https://data.leadleap.net/v1/companies/by-domain/stripe.com

One indexed lookup, the full canonical row back. Want to try without an account? Playground is IP-rate-limited at 20 calls/day.

The endpoints

The whole public surface fits on this card. Costs are per call, in units. Free tier = 5,000 units/day.

POST/v1/companies/search2uSearch the enriched company directory by country, industry, firm_type, etc.GET/v1/companies/by-domain/{domain}10uSingle-domain canonical lookup.POST/v1/companies/by-domain10uBatch version, up to 5 domains per call.POST/v1/contacts/search2uPeople search. Returns an empty page + coverage_note until the directory ships; shape is final.POST/v1/entity/resolve1uResolve a (kind, value) to a token id. Use this before walking the graph.GET/v1/entity/{id}/edges2uList co-sightings from a token. Typical use: domain to associated emails/phones/LinkedIn.POST/v1/email/validate3uSyntax, MX, SMTP, SPF/DMARC, catch-all, role-based. Single or bulk.GET/v1/sources1uPublic dataset catalog.GET/v1/schema1uProgrammatic filter dictionary per endpoint.POST/v1/find2uDEPRECATED. Sunsets 2026-06-16. Migrate to the endpoints above.GET/healthfreeComponent health. No auth required.

Response envelope

Every successful search call returns the same envelope. Fields are always present, null when unknown, never omitted. warningsand errors surface partial-data conditions explicitly.

{
  "results": [ { ...row... } ],
  "total": 142,
  "returned": 5,
  "limit": 5,
  "offset": 0,
  "type": "companies",
  "sources_searched": ["leadleap_enriched_companies"],
  "coverage_note": "...",
  "warnings": [],
  "errors":   []
}

Authentication

Bearer keys, issuance, rotation.

Rate limits

30/min, 5,000 units/day, per account.

Companies — Search

Filter + free-text on the enriched company directory.

Companies — By domain

One indexed lookup, canonical entity row.

Entity index

Resolve a string, walk co-sightings, get associated people.

Validate email

Single or bulk; syntax + SMTP + SPF/DMARC.