# The Data City, contact us, Beta API key, POST /v1/us/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 8 of the 13 key fields we check: Description, Industry, 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-us-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/us/companies/filter-companies
- Sold by: The Data City (https://thedatacity.com)
- Checked: 2026-10-25

## In the answer

- Completeness: 62%
- Description: ✓
- Industry: ✓
- 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: NAICS, Name, Country, EmployeeRange, LegalForm, LegalForms, HQPostcode, DateOfIncorporation, IncorporationDateFrom, IncorporationDateTo, HasWebsite, OperatingLocationAddresses, MinTurnover, MaxTurnover, MinEBIT, MaxEBIT, MinNetIncome, MaxNetIncome, FinancialYearEnding, MinFinancialYearEnding, MaxFinancialYearEnding, AccountsType, RTICs, RNAICS, State, Zipcode, Town, Director, LowerLatitude, UpperLatitude, LowerLongitude, UpperLongitude, HasWebText, Includes, Excludes, WebTextPositiveKeywords, WebTextPositiveKeywordsOperator, WebTextPositiveKeywordsMode, WebTextNegativeKeywords, WebTextNegativeKeywordsOperator, WebTextNegativeKeywordsMode, IncludeInsights, IncludeTotalCount, IncludesLocations, Limit, Offset, SortBy
- Method: POST
- Path: /v1/us/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 80 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, address, town, state, phone, reg number, ZIP code, latitude, longitude, companies in group, employees, employees total, turnover, finances by year, best estimate growth percentage per year, directors, activity code, activity code name, SIC code, SIC code name, NAICS code, RNAICS, similar companies, RTIC company number, RTIC sector code, RTIC sector name, RTIC vertical code, RTIC vertical name, RTIC score, RTIC words matched, RTIC name, finances by year year ending, finances by year accounts date, finances by year accounts type, finances by year turnover, finances by year EBIT, finances by year net income, finances by year employees here, finances by year employees total, director first name, director last name, director full name, director local pnr, director date of birth, director date of change, director active, director position, director gender, director language, RNAICS company number, RNAICS code, RNAICS name, RNAICS score, similar company company number, similar company similarity score, total results, insights, insight employee ranges, insight legal forms, insight incorporation dates, insight RTICs, insight NAICS, insight employees, insight turnover, insight states, insight RNAICS, 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/us/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-us-companies/llms.txt): 62% 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/us/companies](https://datacircle.dev/company-discovery-apis/the-data-city/contact-us-beta-api-key-post-v1-us-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

- [Waterfall.io, contact us](https://datacircle.dev/company-discovery-apis/waterfall-io/contact-us/llms.txt): 69% complete
- [Exa, contact us, Enterprise, POST /v0/websets/{webset}/searches](https://datacircle.dev/company-discovery-apis/exa/contact-us-enterprise-post-v0-websets-webset-searches/llms.txt): 69% complete
- [Instantly, contact us](https://datacircle.dev/company-discovery-apis/instantly/contact-us/llms.txt): 62% complete
- [Cleanlist, contact us](https://datacircle.dev/company-discovery-apis/cleanlist/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/index.md
- https://docs.thedatacity.com/global-api/us/companies/filter-companies.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