Field mapping
Search filters
With a coding agent
Check the fit first
Switch company enrichment in five minutes
This is the shortest path: a business match and firmographics call, replaced by one enrichment call with the Python SDK.Get an API key
COMPANYENRICH_API_KEY. Check it with GET /v2/me, which is free:Install the SDK
Replace the calls
Update the fields you read
Handle no match
200 with a business_id of null. CompanyEnrich returns 404, and the SDK raises NotFoundError. It is not charged.What takes longer
Migrate with a coding agent
A coding agent can do the inventory, the rewrite, and the tests. Give it this prompt in your repository:Move your MCP setup
If your agent uses the Explorium MCP server, point it at the CompanyEnrich server instead. The hosted server is athttps://mcp.companyenrich.com/mcp. For example, in Claude Code:
Endpoint mapping
Both API versions are listed. A v1 path such as/v1/businesses/match maps the same way as its v2 path. Where an Explorium call takes business_ids or prospect_ids, send the company’s domain, or the CompanyEnrich person ID, instead. Explorium IDs cannot be converted.
Company
People
Supporting APIs
Request and response differences
Authentication
From match and enrich to one call
Explorium works in two steps: match a business or prospect to get its ID, then pass the ID to each enrichment you need. v2 can also match and enrich in one call withbusinesses_to_match.
CompanyEnrich returns the record from the lookup itself:
- Enrich a company by domain with
GET /v2/companies/enrich, or by name or social profile withPOST /v2/companies/enrich. - Add data with the
expandparameter instead of separate enrichment calls:technologies,financial,workforce,keywords, ornaicsCodes. - Enrich a person by work email with
POST /v2/people/enrich, or find people with people search.
Response shape
Status codes
200 response, as a null ID, while CompanyEnrich returns 404. Explorium returns 403 when your credits run out, while CompanyEnrich returns 402. The SDK raises a typed exception for each non-2xx status, such as NotFoundError, PaymentRequiredError, and RateLimitError.
Billing behavior that affects your code
These differences change how you write retries, guards, and tests. Prices for each endpoint are in Credits.- No match is free. Enrichment that finds nothing returns
404and is not charged. - An empty search is charged. A search with no results costs one result’s base price, such as 1 credit for a filter search. Check a new filter with the free count endpoint first.
- Extra company fields are expansions. The base record excludes
financial,keywords,naicsCodes,technologies, andworkforce. Each one you request adds 1 credit per company returned, so request only the ones your code reads. - Work emails are a separate call.
GET /v2/people/{personId}/emailcosts 10 credits only when it finds an email your account has not accessed before. - Responses report their cost. Read
x-credit-costandx-credit-remainingfrom the response headers.
Pagination
nextCursor is omitted on the last page, and a cursor expires 24 hours after the first page. The Python SDK pages for you with search_all().
Rate limits
Explorium counts each ID in a request toward 200 queries per minute. CompanyEnrich counts requests: a global limit of 500 requests per minute per IP address, and a per-route limit from your plan, reported inx-ratelimit-limit, x-ratelimit-remaining, and x-ratelimit-window. A batch of 50 domains is one request. The SDKs wait and retry on 429. See Rate limits.
Text, URLs, and codes
IDs
Explorium IDs and CompanyEnrich IDs are separate. CompanyEnrich company IDs are UUIDs, and person IDs are 64-bit integers. Store the CompanyEnrich ID next to the Explorium ID, and re-key company data on its domain.Verify parity on your own data
Measure CompanyEnrich on records you already have before you switch. This makes no Explorium requests, so it works after AgentSource is discontinued.Check your key and plan
GET /v2/me. It is free and returns your balance and plan capabilities.Pick a sample
Compare the fields you read
equal, differ, only Explorium, only CompanyEnrich, or both empty. Fields marked lossy in the field mapping differ by definition, so leave them out or compare them by hand.Check searches and people
compare.py
compare.py
Cut over
- Put the CompanyEnrich path behind a feature flag, and switch it on before Explorium stops serving requests.
- Store CompanyEnrich IDs next to Explorium IDs, and keep the Explorium values you stored.
- Log
x-credit-costper call for the first weeks. - Remove the Explorium client, keys, and MCP configuration once nothing calls them.
What has no equivalent
Plan a replacement for these, because there is no Explorium to fall back on:What you can add after migrating
Semantic company search
Similar companies
Company headcount
MCP server
Common questions
Can I keep using my Explorium business IDs?
Can I keep using my Explorium business IDs?
Do I need to match before I enrich?
Do I need to match before I enrich?
Is there an equivalent of each Explorium enrichment?
Is there an equivalent of each Explorium enrichment?
Can I get phone numbers?
Can I get phone numbers?
GET /v2/people/{personId}/email.How do I get the total number of results?
How do I get the total number of results?
Do batch and bulk enrichment need a specific plan?
Do batch and bulk enrichment need a specific plan?
Why are place names in a different case?
Why are place names in a different case?