thecompaniesapi.com APIthecompaniesapi.com ↗
Enrich company profiles with 300+ data points, search by industry, get AI-generated insights, and find email patterns via The Companies API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/b8ec84b7-dbf3-475a-958f-f59433f0188c/get_pricing' \ -H 'X-API-Key: $PARSE_API_KEY'
Get pricing plans for The Companies API. Returns monthly and annual rates, credits, and features for Startup, Scaleup, and Enterprise tiers.
No input parameters required.
{
"type": "object",
"fields": {
"annual": "array of annual plan objects with plan name, price, total_yearly cost, and credits",
"monthly": "array of monthly plan objects with plan name, price, credits, additional_credit_cost, and rate_limit",
"features": "array of feature name strings included in all plans"
},
"sample": {
"data": {
"annual": [
{
"plan": "Startup",
"price": 79,
"credits": 50000,
"total_yearly": 948
}
],
"monthly": [
{
"plan": "Startup",
"price": 95,
"credits": 50000,
"rate_limit": "50 requests/sec",
"additional_credit_cost": 0.0019
}
],
"features": [
"Real-time data",
"80+ data points",
"Advanced search",
"AI-powered search",
"Email patterns",
"Similar companies",
"Analytics & Exports"
]
},
"status": "success"
}
}About the thecompaniesapi.com API
This API provides 7 endpoints covering company enrichment, search, AI-generated context, and email pattern discovery against The Companies API database. The enrich_company_from_domain endpoint returns over 300 data points per company — including financials, social profiles, headquarters address, and founding year — while fetch_company_context delivers AI-generated content such as product features, customer segments, and pricing summaries.
Company Enrichment and Profile Data
The enrich_company_from_domain endpoint accepts a domain parameter and returns structured company data across several grouped response objects: about (name, industry, employee count, year founded, business type), finances (stock exchange, revenue range, stock symbol), locations (headquarters address), socials (LinkedIn, Twitter, Facebook URLs), assets (logo and cover image URLs), and descriptions (tagline, website description, primary description). An api_key is required for most domains; a small set of well-known domains such as microsoft.com work without one.
Search, Count, and Industry Discovery
The search_companies endpoint accepts search (keyword matching against company names and domains), query (a JSON array string for structured attribute filters such as industry or employee range), page, and size parameters. The meta object in the response includes currentPage, lastPage, perPage, and total for pagination. count_companies returns a raw integer count of matching records, and search_industries exposes industry label, value (slug usable as a filter key in search_companies), and companiesCount — making it the right starting point when building industry-based filters.
AI Context and Email Patterns
fetch_company_context returns a context object containing ideated AI-generated sections — about, customers, features, pricing, and more — alongside source URLs and the full underlying company record. The meta object includes a token count reflecting the size of the generated output. find_company_email_patterns returns an array of patterns, each with a pattern string (e.g. [F].[L]) and a usagePercentage, indicating the most common email format structures observed for that domain.
- Populate a CRM with company firmographics (industry, employee count, revenue range, founding year) by passing a domain to
enrich_company_from_domain. - Build an account-based marketing list by filtering
search_companieswith a JSON query on industry slug discovered viasearch_industries. - Validate inbound signup domains against enriched company data to segment users by company size or business type.
- Generate sales intelligence briefs by pulling AI-authored company summaries, customer segments, and feature descriptions from
fetch_company_context. - Construct email address candidates for outreach by applying email format patterns returned by
find_company_email_patternsto known contact names. - Track database coverage for a specific industry by calling
count_companieswith an industry filter query.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does The Companies API have an official developer API?+
What does the `query` parameter in `search_companies` accept and how does it filter results?+
query parameter takes a JSON array string where each element is an object with attribute, operator, and value keys — for example, [{"attribute":"industry","operator":"=","value":"software-development"}]. Industry slug values suitable for this filter can be discovered using search_industries. Combining multiple filter objects narrows results further. The search parameter runs a separate keyword match against company names and domains and can be used alongside query.Does the API return individual employee or contact records?+
How fresh is the enrichment data, and is there a way to force a refresh?+
enrich_company_from_domain response includes a meta object with sync metadata indicating when the record was last updated. There is no explicit cache-bust or refresh parameter exposed in the current endpoint inputs — the returned data reflects whatever is current in The Companies API database at the time of the request.Does the API expose historical financials or time-series data for companies?+
finances object from enrich_company_from_domain returns a point-in-time snapshot of revenue range, stock exchange, and stock symbol — not historical series. You can fork this API on Parse and revise it to add endpoints that aggregate or track financial changes over time if that is required.