Skip to main content

​
Selectable columns

Default for POST …/v2/search and POST …/v2/fetch: ["domain", "name", "country"]. Request a subset via columns. domain is always included in each row. Allowed column names:
ColumnTypical use
domainPrimary identifier (hostname)
nameLegal or trade name
summaryShort text description
summary_keywordsExtracted keyword tags
addressStreet address
organization_typee.g. Company, Startup
organization_sizeSize band
employee_classEmployee count bracket
revenue_classRevenue bracket
nace_codeIndustry (NACE)
continent, country, country_codeGeography
state, state_code, region, region_codeSubnational hierarchy
district, district_code, municipality, municipality_codeFiner admin units
lat, lonCoordinates (may be null)
new_register_entryRecently registered flag
company_register_date, company_register_idRegister metadata
created_atRow creation time
Never returned: raw long text used only for indexing, embedding vectors, and internal flags such as has_embedding.

​
Filters object

All keys are optional. Lists mean “match any of these values” for that field (OR inside the field).
FieldMatches
country, state, region, district, municipalityExact string on the corresponding column
organization_typee.g. Company, Startup, Public, Academic, Other
organization_sizee.g. Micro (0-9), Small (10-49), Medium-sized (50-249), Large enterprise (250+)
nace_codeSection letter (e.g. K) or detailed code (e.g. 62.01)
sourceData provenance bucket
company_register_courtCourt / register name
register_date_from, register_date_toInclusive ISO dates (YYYY-MM-DD) on registration dates
summary_keywordsFast exact match on keyword array
text_keywordsSame object shape as top-level keywords: BM25 sub-filter on text
Use GET …/v2/filters/options for values your key may actually use.

​
Rate limits and tiers

Throughput and monthly quotas depend on your key’s tier (enforced at the gateway and in service middleware). Typical public tier profile:
TierApprox. steady RPSBurstMonthly request quota
tier_12510,000
tier_251050,000
Monthly POST /stats request quotas (per key, per calendar month):
Tier/stats requests/month
tier_1500
tier_25,000
Result rows also count against monthly result quotas where configured (/search and /fetch). /stats counts requests only. Responses may include rate-limit headers, for example: 
X-RateLimit-Requests-Limit: 10000
X-RateLimit-Requests-Remaining: 9843
X-RateLimit-Results-Limit: 500000
X-RateLimit-Results-Remaining: 498231
X-RateLimit-Reset: 2026-04-01T00:00:00Z
When limits are exceeded, the API returns 429 Too Many Requests.

​
HTTP errors

StatusMeaning
400Malformed or inconsistent input
401Missing or invalid API key
403Authenticated but action not allowed for this tier
422Validation error (body fails schema or business rules)
429Rate or quota exceeded
500Unexpected server error
Error bodies are usually JSON with a detail or error field you can log.