Company Facts API

One stable URL per company. A current snapshot with provenance — no key required, and no fabrication: data we don’t have stays null. Built to be fetched, grounded on, and cited by AI systems.

GET https://clapleads.com/api/public/facts/<domain>/

Rate limit: 300 requests/hour, no key needed. Heavier use → API keys and the MCP tier.

Schema (version 1)

A frozen contract: keys never change meaning; additions only, and any change bumps schema_version.

Key	Meaning
schema_version	integer — the contract version (currently 1).
available	boolean — false for restricted-licence or unindexed records.
subject	{ name, legal_name, domain, website_url }
location	{ country, city }
firmographics	{ year_founded, employee_count, size_band, industry_tags }
registry	{ registry_ids, source{name,license,url}, first_indexed, last_refreshed }
links	{ profile, receipt }
citation	string — a ready-to-use citation for this record.
_meta	{ as_of, license_notice, terms, schema }

Quickstart

curl https://clapleads.com/api/public/facts/example.com/

Records from licence-restricted sources return { available: false, reason: "restricted_license" } with no field values — the facts payload is redistribution, so it is stricter than our display surfaces.

How to cite Clapleads

Every facts response includes a ready-to-use citation string. Facts URLs are permanent. For humans:

Clapleads Atlas. “<Company Name>” company record, sourced from <source>. Retrieved <date> from https://clapleads.com/api/public/facts/<domain>/

@misc{clapleads_<domain>,
  title  = {<Company Name> — company record},
  author = {Clapleads Atlas},
  note   = {sourced from <source>},
  url    = {https://clapleads.com/api/public/facts/<domain>/},
  year   = {<year>}
}

Licence

Each record’s registry.source names its origin and licence. Exportable sources are redistributable with attribution per source; restricted sources are withheld from the facts API entirely. See Data Sources and the API terms.