CompanyEnrich company and people intelligence

Use CompanyEnrich to build a company shortlist, inspect employee growth, find
relevant professionals or enrich a known business. Inspect the live catalog for
availability, schemas and pricing before running. The calling agent evaluates
relevance and completeness; native similarity ranks are provider evidence.

scrappycoco catalog inspect company.search_records --json

Save this as request.json:

{
  "input": {"body": {"query": "Stripe", "pageSize": 1}},
  "providers": ["companyenrich_api"],
  "provider_options": {"companyenrich_api": {}},
  "limit": 1
}

scrappycoco run company.search_records --file request.json --output companies.json --json

Read the records and full receipt. Check provider HTTP status, errors, exact
request/options, pagination and credit evidence. A completed gateway job does not
prove that a provider succeeded or its results satisfy your request. REST and MCP
use the same input and options; MCP uses scraper_id: "company.search_records".

Outcome	Capabilities
Enrich a company	`company.enrich_domain`, `company.enrich_properties`, `company.get_record`
Search companies	`company.search_records`, `company.search_count`, `company.search_preview`, `company.search_scroll`
Find lookalikes	`company.find_similar`, `company.similar_count`, `company.similar_preview`, `company.similar_scroll`
Company workforce and suggestions	`company.workforce`, `company.autocomplete`
People and roles	`people.search`, `people.scroll`, `people.get_record`, `people.education`
Reverse email and email resolution	`people.lookup_email`, `people.email`
Native domain batch	`company.enrich_batch`
Filter dictionaries	`reference.regions`, `reference.country`, `reference.countries`, `reference.states`, `reference.cities`, `reference.industries`, `reference.keywords`, `reference.technologies`, `reference.positions`

Native POST fields are in input.body; required query/path parameters are directly
in input. Optional query parameters such as expansions are in the inspected
provider options. Domain enrichment uses provider companyenrich_enrich_domain,
email resolution uses companyenrich_email, and the other routes use
companyenrich_api. Always inspect rather than guessing options or filter enums.

CompanyEnrich company IDs are UUIDs and person IDs are integers; they do not share
Coresignal's identifier namespace. CompanyEnrich record search differs from
Coresignal ID search (company.search, employee.search). Preserve the selected
provider, native query and options in saved configurations.

Explicit native pageSize takes precedence over limit. If omitted where
supported, min(limit, 100) supplies the page size. Complete returned pages remain
available even when larger than the requested limit. Follow nextCursor via
body.cursor, or page/totalPages via body.page, within the user's scope.
Paged company/people search has a 10,000-result ceiling. Previews can require a
higher provider plan; a preview denial does not mean ordinary search is unavailable.

For domain enrichment, input.items uses native batches of 50. Setting native
waitForEnrichment=false uses individual requests because batch enrichment has
no equivalent option. People email batches use native async jobs, preserve job IDs,
and correlate by person/domain. Unknown submissions are not silently replayed.
Inspect native batch failures and saved state before retrying.

Workforce expansion adds five credits per company; education adds one per person.
Email is beta and reports native status/certainty. It charges for newly accessed
found emails, so a successful repeated lookup does not establish a new charge.
Unknown USD pricing or usage is shown as unresolved, never assumed free. A public
business email is not permission to contact someone or a deliverability guarantee.

The full provider API also includes provider.* bulk/export jobs, saved lists and
account information. These act on a shared provider account and require gateway
owner access. Native list filters are likewise owner-only. They are not customer
workarounds for accessing upstream jobs by ID. Async job status preserves its
original credit charge; a status read does not charge that job again.

Official CompanyEnrich documentation.