# The Data City, contact us, Beta API key, POST /v1/ie/companies: Company discovery API

> Returns filtered companies and aggregations as host-defined JSON.

The Data City's company discovery API on its Beta API key plan. It returns 7 of the 13 key fields we check: Description, Type and status, Images, Employees, Headquarters, Revenue and budgets, Phones.
The cheapest of the 111 plans we rank by price is [Context.dev, $500 monthly](https://datacircle.dev/company-discovery-apis/context-dev/500-monthly/llms.txt), at $0.01 per 1,000.

- This page: https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-ie-companies
- [Best company discovery API in 2026](https://datacircle.dev/best-company-discovery-api.txt)
- Get it: https://thedatacity.com/pricing
- Its API docs: https://docs.thedatacity.com/global-api/ie/companies/filter-companies
- Sold by: The Data City (https://thedatacity.com)
- Checked: 2026-10-25

## In the answer

- Completeness: 54%
- Description: ✓
- Type and status: ✓
- Images: ✓
- Employees: ✓
- Headquarters: ✓
- Revenue and budgets: ✓
- Phones: ✓

## Price

- Billing: contact

## Aggregators

- Aggregators: none

## Charges

- Most per search: no limit

## In their words

- Their pitch: Returns filtered companies and aggregations as host-defined JSON.

## Data

- Keep data: no API terms
- Use data: no API terms

## Rate limit

- Per second: 1

## Speed

- Answer: in the call

## The call

- You send: nothing required. Optional: NACEs, Name, Country, LegalForm, LegalForms, HQPostcode, DateOfIncorporation, IncorporationDateFrom, IncorporationDateTo, HasWebsite, OperatingLocationAddresses, MinTurnover, MaxTurnover, MinEBIT, MaxEBIT, MinNetIncome, MaxNetIncome, FinancialYearEnding, MinFinancialYearEnding, MaxFinancialYearEnding, AccountsType, RTICs, RNACEs, State, Zipcode, Town, LowerLatitude, UpperLatitude, LowerLongitude, UpperLongitude, HasWebText, Includes, Excludes, WebTextPositiveKeywords, WebTextPositiveKeywordsOperator, WebTextPositiveKeywordsMode, WebTextNegativeKeywords, WebTextNegativeKeywordsOperator, WebTextNegativeKeywordsMode, IncludeInsights, IncludeTotalCount, IncludesLocations, Limit, Offset, SortBy
- Method: POST
- Path: /v1/ie/companies

## About the plan

- Plan: Beta API key
- Who can get it: an organisation that emails support@thedatacity.com its name, the email of the person who will hold the key and the markets it expects to use

## The 71 fields the plan's answer can hold

company description, legal form, employee range, RTICs, logo URL, screenshot URL, operating locations count, company number, company name, website, country, headquarters address, headquarters postcode, headquarters postcode details, address, town, state, phone, ZIP code, latitude, longitude, employees, turnover, NACEs, RNACEs, similar companies, RTIC company number, RTIC sector code, RTIC sector name, RTIC vertical code, RTIC vertical name, RTIC score, RTIC words matched, RTIC name, headquarters postcode details department name, headquarters postcode details organisation name, headquarters postcode details sub building name, headquarters postcode details building name, headquarters postcode details PO box number, headquarters postcode details building number, headquarters postcode details building group, headquarters postcode details dependent street, headquarters postcode details main street, headquarters postcode details double dependent locality, headquarters postcode details dependent locality, headquarters postcode details post town, headquarters postcode details county, headquarters postcode details postcode, headquarters postcode details latitude, headquarters postcode details longitude, RNACEs company number, RNACEs code, RNACEs name, RNACEs score, similar company company number, similar company similarity score, total results, insights, insight employee ranges, insight legal forms, insight incorporation dates, insight RTICs, insight NACEs, insight employees, insight turnover, insight states, insight RNACEs, insight bucket ID, insight bucket name, insight bucket count, insight bucket children

## The Data City's plans (1)

- [The Data City, contact us, Beta API key, POST /v1/ie/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-ie-companies/llms.txt): 54% complete

## The Data City's calls (8)

- `POST /v1/fr/companies`: [The Data City, contact us, Beta API key, POST /v1/fr/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-fr-companies/llms.txt)
- `POST /v1/de/companies`: [The Data City, contact us, Beta API key, POST /v1/de/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-de-companies/llms.txt)
- `POST /v1/ie/companies`: [The Data City, contact us, Beta API key, POST /v1/ie/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-ie-companies/llms.txt)
- `POST /v1/us/companies`: [The Data City, contact us, Beta API key, POST /v1/us/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-us-companies/llms.txt)
- `GET /v1/fr/search`: [The Data City, contact us, Beta API key, GET /v1/fr/search](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-get-v1-fr-search/llms.txt)
- `GET /v1/de/search`: [The Data City, contact us, Beta API key, GET /v1/de/search](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-get-v1-de-search/llms.txt)
- `GET /v1/ie/search`: [The Data City, contact us, Beta API key, GET /v1/ie/search](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-get-v1-ie-search/llms.txt)
- `GET /v1/us/search`: [The Data City, contact us, Beta API key, GET /v1/us/search](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-get-v1-us-search/llms.txt)

## The Data City's APIs (6)

- [The Data City: similar companies API pricing, 2 plans](https://datacircle.dev/similar-company-apis/the-data-city/free/llms.txt)
- [The Data City: company discovery API pricing, 1 plan, POST /v1/ie/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-ie-companies/llms.txt)
- [The Data City: company enrichment API pricing, 1 plan, GET /v1/fr/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-fr-companies-companynumber/llms.txt)
- [The Data City: company enrichment API pricing, 1 plan, GET /v1/de/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-de-companies-companynumber/llms.txt)
- [The Data City: company enrichment API pricing, 1 plan, GET /v1/ie/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-ie-companies-companynumber/llms.txt)
- [The Data City: company enrichment API pricing, 1 plan, GET /v1/us/companies/{companyNumber}](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-get-v1-us-companies-companynumber/llms.txt)
- [The Data City: company enrichment API pricing, 1 plan, POST /v1/fr/companies/batch](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-post-v1-fr-companies-batch/llms.txt)
- [The Data City: company enrichment API pricing, 1 plan, POST /v1/de/companies/batch](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-post-v1-de-companies-batch/llms.txt)
- [The Data City: company enrichment API pricing, 1 plan, POST /v1/ie/companies/batch](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-post-v1-ie-companies-batch/llms.txt)
- [The Data City: company enrichment API pricing, 1 plan, POST /v1/us/companies/batch](https://datacircle.dev/company-enrichment-apis/the-data-city/contact-us-beta-api-key-post-v1-us-companies-batch/llms.txt)
- [The Data City: company hierarchy API pricing, 2 plans, GET /v1/de/companies/{companyNumber}/group](https://datacircle.dev/company-hierarchy-apis/the-data-city/contact-us-beta-api-key-get-v1-de-companies-companynumber-group/llms.txt)
- [The Data City: company hierarchy API pricing, 2 plans, GET /v1/ie/companies/{companyNumber}/group](https://datacircle.dev/company-hierarchy-apis/the-data-city/contact-us-beta-api-key-get-v1-ie-companies-companynumber-group/llms.txt)
- [The Data City: company hierarchy API pricing, 2 plans, GET /v1/us/companies/{companyNumber}/group](https://datacircle.dev/company-hierarchy-apis/the-data-city/contact-us-beta-api-key-get-v1-us-companies-companynumber-group/llms.txt)
- [The Data City: cached company enrichment API pricing, 1 plan, GET /v2/companies/{companyNumber}](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-get-v2-companies-companynumber/llms.txt)
- [The Data City: cached company enrichment API pricing, 1 plan, POST /v2/companies/batch](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-post-v2-companies-batch/llms.txt)
- [The Data City: cached company enrichment API pricing, 1 plan, POST /v2/companies/by-website/batch](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-post-v2-companies-by-website-batch/llms.txt)
- [The Data City: cached company enrichment API pricing, 1 plan, GET /v2/companies/by-website](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-get-v2-companies-by-website/llms.txt)
- [The Data City: cached company enrichment API pricing, 1 plan, POST /v2/companies/by-website](https://datacircle.dev/cached-company-enrichment-apis/the-data-city/contact-us-api-access-post-v2-companies-by-website/llms.txt)
- [The Data City: cached company discovery API pricing, 1 plan](https://datacircle.dev/cached-company-discovery-apis/the-data-city/contact-us/llms.txt)

## The Data City: company discovery API alternatives

- [Cleanlist, contact us](https://datacircle.dev/company-discovery-apis/cleanlist/contact-us/llms.txt): 54% complete
- [Explorium, contact us, Enterprise, POST /v2/businesses, Fetch businesses](https://datacircle.dev/company-discovery-apis/explorium/contact-us-enterprise-post-v2-businesses-fetch-businesses/llms.txt): 54% complete
- [NeuralVerge, contact us, Custom, POST /functions/v1/run-tracxn-companies-search](https://datacircle.dev/company-discovery-apis/neuralverge/contact-us-custom-post-functions-v1-run-tracxn-companies-search/llms.txt): 54% complete, live
- [Signalbase, contact us](https://datacircle.dev/company-discovery-apis/signalbase/contact-us/llms.txt): 54% complete

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-10-25.

- https://docs.thedatacity.com/global-api/guides/authentication.md
- https://docs.thedatacity.com/global-api/guides/pagination.md
- https://docs.thedatacity.com/global-api/guides/rate-limits.md
- https://docs.thedatacity.com/global-api/ie/companies/filter-companies.md
- https://docs.thedatacity.com/global-api/index.md
- https://docs.thedatacity.com/instant-classification/guides/rate-limits.md
- https://thedatacity.com/api-access
- https://thedatacity.com/pricing
- https://thedatacity.com/terms-and-conditions