The Companies API APIthecompaniesapi.com ↗
Enrich company profiles with 300+ data points, search by industry, get AI-generated insights, and find email patterns via The Companies API.
What is the The Companies API 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace thecompaniesapi-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""The Companies API — company enrichment, search, and AI insights."""
from parse_apis.the_companies_api import TheCompaniesAPI, Domain, CompanyNotFound
client = TheCompaniesAPI()
# Search for companies by keyword, capped at 3 results.
for summary in client.companysummaries.search(search="stripe", limit=3):
print(summary.domain, summary.name, summary.industry)
# Count total companies in the database.
total = client.companysummaries.count()
print(total.count)
# Enrich a specific company by domain — full 300+ data points.
company = client.companies.get(domain=Domain.MICROSOFT_COM)
print(company.about.name, company.about.industry, company.about.year_founded)
# Walk email patterns for the enriched company.
for pattern in company.email_patterns(limit=5):
print(pattern.pattern, pattern.usage_percentage)
# Discover industries matching a keyword.
for industry in client.industries.search(search="software", limit=3):
print(industry.label, industry.companies_count)
# Typed error handling: catch a missing domain.
try:
client.companies.get(domain="nonexistent-domain-xyz.invalid")
except CompanyNotFound as exc:
print(f"Domain not found: {exc.domain}")
print("exercised: companysummaries.search / count / companies.get / email_patterns / industries.search / CompanyNotFound")
Retrieve pricing plans for The Companies API. Returns monthly and annual rates, credits, and features for Startup, Scaleup, and Enterprise tiers. No parameters required — returns static plan information.
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
},
{
"plan": "Scaleup",
"price": 245,
"credits": 250000,
"total_yearly": 2940
},
{
"plan": "Enterprise",
"price": 495,
"credits": 500000,
"total_yearly": 5940
}
],
"monthly": [
{
"plan": "Startup",
"price": 95,
"credits": 50000,
"rate_limit": "50 requests/sec",
"additional_credit_cost": 0.0019
},
{
"plan": "Scaleup",
"price": 295,
"credits": 250000,
"rate_limit": "100 requests/sec",
"additional_credit_cost": 0.0011
},
{
"plan": "Enterprise",
"price": 595,
"credits": 500000,
"rate_limit": "200 requests/sec",
"additional_credit_cost": 0.001
}
],
"features": [
"Real-time data",
"80+ data points",
"Advanced search",
"AI-powered search",
"Email patterns",
"Similar companies",
"Analytics & Exports"
]
},
"status": "success"
}
}About the The Companies API API
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.
The The Companies API API is a managed, monitored endpoint for thecompaniesapi.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when thecompaniesapi.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official thecompaniesapi.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.