CompanyData APIcompanydata.com ↗
Search the CompanyData.com registry by name, city, SIC code, revenue, and legal type. Get contact details, industry, and top-company tables for UAE, UK, and more.
What is the CompanyData API?
The CompanyData.com API exposes 2 endpoints that cover the site's global company registry, returning up to 100 company records per call with fields including registration numbers, SIC industry codes, revenue brackets, founding year, and contact details. The search_companies endpoint lets you filter by city, free-text name, SIC code, revenue range, and legal type, while get_country_top_companies returns the 25 highest-revenue companies alongside registry-wide statistics for a given country.
curl -X GET 'https://api.parse.bot/scraper/d4ce4b15-2dc8-48e0-9237-640af3f9c8f6/search_companies?country_code=AE' \ -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 companydata-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.
"""Walkthrough: CompanyData.com API — search companies and read country reports."""
from parse_apis.companydata_com_api import CompanyData, OrderBy, LegalType, CountryNotFound
client = CompanyData()
# Search for banking corporations in the UAE, sorted by revenue.
listing = client.companies.search(
country_code="AE",
query="bank",
legal_type=LegalType.CORPORATION,
order_by=OrderBy.REVENUE_DESC,
page_size=5,
)
print(f"Found {listing.total_count} matches across {listing.total_pages} pages")
for company in listing.companies:
print(company.name, company.city, company.industry)
# Drill into a country report for aggregate statistics.
report = client.country_reports.get(country_slug="uae")
print(f"{report.page_title}: {report.total_count} companies")
print(f"Top legal status: {report.top_legal_status.name} ({report.top_legal_status.count})")
print(f"Fields with phone data: {report.field_coverage_counts.phone}")
# Revenue bracket breakdown.
for bracket, count in report.companies_by_revenue_bracket_usd.items():
print(f" {bracket}: {count}")
# Top-revenue companies from the report.
for company in report.companies[:3]:
print(company.name, company.employees_total, company.yearly_revenue_usd)
# Handle an unknown country gracefully.
try:
client.country_reports.get(country_slug="xyznotacountry")
except CountryNotFound:
print("Country slug not recognised")
print("exercised: companies.search / country_reports.get / CountryNotFound")
Searches the CompanyData.com company registry for one country and returns the first page of matching companies (the site only lets unregistered visitors view page 1, so no further pages are available; page_size controls how many of the top results are returned, up to 100). Filters narrow by name text, city, 4-digit SIC industry code, legal form, founding year, employee-count range and yearly-revenue range; order_by sorts by revenue or headcount. Each company row carries id, name, SIC code and industry description, city, state/province, country, founding year, registration number, legal type and group headquarters fields. Contact fields (phone, mobile, address lines, email, website) are partially masked by the site for unregistered visitors (e.g. one shape is '+9*****23'); employees_total, yearly_revenue_usd and legal_type_code are always null on this endpoint (use get_country_top_companies for those). total_count is the site's full match count across all pages. A filter set with no matches returns an empty companies list with total_count 0.
| Param | Type | Description |
|---|---|---|
| city | string | City name filter, matched by the site case-insensitively (e.g. SHARJAH). Omitted = all cities. |
| query | string | Free-text search over company names (e.g. bank). Omitted = no name filter. |
| order_by | string | Sort order of the results. Omitted = the site's default ordering. |
| sic_code | string | 4-digit SIC industry code, leading zeros preserved (e.g. 6021 for Banking). Omitted = all industries. |
| page_size | integer | Number of companies to return from the first page; values above 100 are clamped to 100, below 1 to 1. |
| legal_type | string | Business legal form code from the site's legal-type filter; the value is forwarded to the site unchanged. Omitted = all legal types. |
| revenue_max | integer | Maximum yearly revenue in US dollars. Omitted = no upper bound. |
| revenue_min | integer | Minimum yearly revenue in US dollars. Omitted = no lower bound. |
| country_code | string | 2-letter ISO country code of the registry to search (e.g. AE for the United Arab Emirates, NL for the Netherlands). |
| employees_max | integer | Maximum total employees. Omitted = no upper bound. |
| employees_min | integer | Minimum total employees. Omitted = no lower bound. |
| founding_year | integer | Exact founding year (4 digits). Omitted = all years. |
{
"type": "object",
"fields": {
"companies": "array of company records: id, name, trade_name, email, phone, mobile, website, sic_code, industry, address_1, address_2, postal_code, city, state_province, country, founding_year, registration_number, legal_type, legal_type_code, employees_total, yearly_revenue_usd, group_company_count, hq_city, hq_country",
"page_size": "integer, page size the site applied",
"total_count": "integer, total companies matching the filters across the whole registry",
"total_pages": "integer, number of pages the site reports at this page_size (only page 1 is retrievable)",
"country_code": "upper-cased 2-letter country code that was searched"
},
"sample": {
"data": {
"companies": [
{
"id": "0668669462",
"city": "Abu Dhabi",
"name": "Al Maryah Community Bank L.L.C.",
"email": null,
"phone": "+9*****22",
"mobile": "",
"country": "United Arab Emirates",
"hq_city": "Abu Dhabi",
"website": null,
"industry": "National Commercial Banks",
"sic_code": "6021",
"address_1": "454*****",
"address_2": null,
"hq_country": "United Arab Emirates",
"legal_type": "Corporation",
"trade_name": null,
"postal_code": null,
"founding_year": 2021,
"state_province": "Abu Dhabi",
"employees_total": null,
"legal_type_code": null,
"yearly_revenue_usd": null,
"group_company_count": 4,
"registration_number": "CN-4028026"
}
],
"page_size": 5,
"total_count": 68,
"total_pages": 14,
"country_code": "AE"
},
"status": "success"
}
}About the CompanyData API
search_companies
The search_companies endpoint queries the CompanyData.com registry for a single country and returns the first page of matching results. You can narrow results with any combination of query (name substring), city, sic_code (4-digit, leading zeros preserved — e.g. 0621 or 6021), legal_type, revenue_min, and revenue_max (both in USD). The page_size parameter controls how many records come back, up to a maximum of 100. Each company record in the response includes id, name, trade_name, email, phone, mobile, website, sic_code, industry, address fields, postal_code, founding_year, legal_type, registration_number, employees, and yearly_revenue_usd. The response also surfaces total_count and total_pages so you know the scope of your query, though only page 1 is retrievable.
get_country_top_companies
The get_country_top_companies endpoint returns the fixed table of 25 top-revenue companies that CompanyData.com publishes on each country list page, identified by a lowercase country_slug (confirmed values include uae and uk). The company records share the same field shape as those from search_companies. Beyond the company list, the response includes registry-level statistics: total_count, companies_by_city (a map of city name to company count), companies_by_employee_bracket, companies_by_revenue_bracket_usd, field_coverage_counts (counts of companies with CEO, email, phone, address, and website data), and top_legal_status (the most common legal form and how many companies hold it).
Data coverage and limitations
Both endpoints reflect what CompanyData.com makes available without authentication. The search_companies endpoint is limited to page 1 of results — the site restricts deeper pagination to registered users, so total_pages indicates how many pages exist but only the first is returned. The country_slug values for get_country_top_companies are not enumerated in the API; only uae and uk are confirmed to work, and unknown slugs return an error.
The CompanyData API is a managed, monitored endpoint for companydata.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when companydata.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 companydata.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?+
- Build a prospect list of UAE companies filtered by SIC code and minimum yearly revenue.
- Identify the 25 largest companies by revenue in a target country for competitive benchmarking.
- Enrich a CRM by looking up phone, email, and website for companies matched by name and city.
- Analyze industry concentration in a city by aggregating
companies_by_cityandsic_codedata. - Map employee-size distribution across a country's registered companies using
companies_by_employee_bracket. - Cross-reference registration numbers and legal types for due-diligence screening on known company names.
- Track field coverage gaps (email, phone, website) across a country's registry for data-quality audits.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does CompanyData.com have an official developer API?+
What pagination is available in search_companies?+
total_pages. The response includes total_count and total_pages so you can see how large the full result set is, but the CompanyData.com site restricts deeper pagination to registered users, so no further pages are accessible through this API.Which countries are supported by get_country_top_companies?+
uae and uk are confirmed to work as country_slug values. Other country slugs may work if they match CompanyData.com's URL structure, but they are not enumerated in the API and an unknown slug returns an error rather than an empty result.Does the API support retrieving individual company detail pages or director/officer information?+
search_companies and country-level top-company tables via get_country_top_companies. Individual company profiles and officer or director records are not exposed. You can fork this API on Parse and revise it to add an endpoint that fetches a single company's detail page using its id.Can I filter search_companies by multiple SIC codes or multiple cities in one call?+
sic_code string and a single city string. Multi-value filtering is not currently supported. The API covers one filter value per field per request. You can fork it on Parse and revise to add multi-value filter logic across parallel requests.