API reference
Base URL, conventions and the endpoint groups.
Base URL: https://api.companyspec.com/v1
All requests use HTTPS and a bearer API key. Request and response bodies are JSON. Errors use problem details.
| Group | What it does | Cost |
|---|---|---|
| Account | Your plan and remaining allowances | Free |
| Reference data | Valid filter values and tracked technologies | Free |
| Companies | Resolve, look up and enrich companies you name | Lookups (resolve is free) |
| Company data | Page summaries (pricing, legal, security and compliance, integrations…), technologies, headcount, recent hires, funding, news | Lookups |
| Discovery | Count, search, lookalikes, page search, vendor customers | Discoveries (count is free) |
| Job postings | A company's postings and one posting (lookups); posting search (discoveries) | Lookups / discoveries |
Conventions
- Dates are
YYYY-MM-DD. Money is in USD unless a field says otherwise (fields end in_usd). - Missing values are
null(or[]for lists); fields are never left out. - Lists are paginated with
limitandcursor; see Pagination. - Every endpoint that can charge returns a usage block.
Download the OpenAPI spec: companyspec.yaml.