Company Data Search API
API health
- 24h health
- Normal
- 24h average time
- —
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
Find companies from a one-sentence description, optionally by country and headcount, with headquarters, headcount, revenue estimate, funding stage and rounds.
Price $3.19 per 1,000 requests ($0.003194 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.
AI prompt
Please help me write a data collection script with the EveryInfra Company Data Search endpoint (company_data/search).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to company_data and action to search, and put the parameters inside params.
- Required parameters:
- keyword: search: a one-sentence description of the companies to find, up to 500 characters, such as payment infrastructure companies in Ireland.
- Optional parameters:
- country: Only companies headquartered in this country, as a two-letter code such as US, GB or IE (search).
- employees_max: Maximum headcount for search.
- employees_min: Minimum headcount for search; companies whose headcount range overlaps count.
- limit: The most rows to return in this call, an integer from 1 to 10. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 10)
- Returns a list of records. Main fields of each record: name (Company or brand name, as the dataset w…), domain (The company's main domain, such as stri…), description (What the company does), organization_type (Organization type (search), such as pri…), operating_status (Operating status (search), such as acti…), industries (Industries (search)), founded_year (Year founded (search)), hq_country_code (Headquarters country, two-letter code (…), hq_region (Headquarters state or region (search)), hq_city (Headquarters city (search)), hq_street_address (Headquarters street address (search)), hq_postal_code (Headquarters postal code (search)); 22 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=company_data.
- Example request body:
{
"platform": "company_data",
"action": "search",
"params": {
"keyword": "payment infrastructure companies in Ireland"
}
}
- Price: $3.19 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | company_data | Platform identifier, fixed value. |
action | body | string | Yes | search | Capability identifier, fixed value. |
keyword | body.params | string | Yes | - | search: a one-sentence description of the companies to find, up to 500 characters, such as payment infrastructure companies in Ireland. brand_search: a brand name, domain or the first letters of either, up to 100 characters, such as notion or nik. |
country | body.params | string | No | - | Only companies headquartered in this country, as a two-letter code such as US, GB or IE (search). |
employees_max | body.params | integer | No | - | Maximum headcount for search. |
employees_min | body.params | integer | No | - | Minimum headcount for search; companies whose headcount range overlaps count. |
limit | body.params | integer (1–10) | No | 10 | The most rows to return in this call, an integer from 1 to 10. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |
Code samples
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "company_data",
"action": "search",
"params": {
"keyword": "payment infrastructure companies in Ireland"
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
Response example
No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.
{
"id": "req_…",
"platform": "company_data",
"action": "search",
"results": [
{
"name": …,
"domain": …,
"description": …,
"organization_type": …,
"operating_status": …,
"industries": …,
"founded_year": …,
"hq_country_code": …,
"hq_region": …,
"hq_city": …,
"hq_street_address": …,
"hq_postal_code": …,
"employee_count": …,
"employees_min": …,
"employees_max": …,
"revenue_min_usd": …,
"revenue_max_usd": …,
"funding_total_usd": …,
"funding_round_count": …,
"funding_stage": …,
"latest_round": …,
"funding_rounds": …,
"platform": …
}
],
"count": …,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Response fields
Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.
| Field | Meaning |
|---|---|
name | Company or brand name, as the dataset writes it (enrich names are often lower case). |
domain | The company's main domain, such as stripe.com. |
description | What the company does; for peers, how this company competes with the one you asked about. |
organization_type | Organization type (search), such as privately_held or public_company. |
operating_status | Operating status (search), such as active. |
industries | Industries (search). |
founded_year | Year founded (search). |
hq_country_code | Headquarters country, two-letter code (search). |
hq_region | Headquarters state or region (search). |
hq_city | Headquarters city (search). |
hq_street_address | Headquarters street address (search). |
hq_postal_code | Headquarters postal code (search). |
employee_count | Headcount (search); absent when only a range is known. |
employees_min | Lower bound of the headcount range (search). |
employees_max | Upper bound of the headcount range (search). |
revenue_min_usd | Lower bound of the annual revenue estimate, US dollars (search). |
revenue_max_usd | Upper bound of the annual revenue estimate, US dollars (search). |
funding_total_usd | Total funding raised, US dollars (search); absent without funding records. |
funding_round_count | Number of funding rounds (search). |
funding_stage | Funding stage (search), such as seed, series_a or no_funding_yet. |
latest_round | Most recent funding round (search): type, date and amount_usd. |
funding_rounds | All funding rounds (search), each with type, date and amount_usd. |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
Errors and billing
- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
Official references
Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.
- ISO: ISO 3166 country codes ↗
ISO's official page explains that ISO 3166-1 identifies countries with two-letter codes, which is what US, GB or IE in `country` mean. Where a company is headquartered comes from the returned data, not from this standard.
Checked 2026-11-01