Start company follower scrape

Access required — This endpoint is available to approved accounts only. Contact us to request access.

Starts an asynchronous company follower scrape. Provide a company URL and a max_limit for how many profiles to retrieve.

Cost: Credits per profile (see the /limit endpoint for your team's rate), reserved upfront based on max_limit. When you fetch results, we settle the bill — if fewer profiles were found, the excess credits are refunded automatically.

Filters: Narrow results by country, state/province, metro area, job title, department, or seniority level. A state or metro replaces its country in the search: countries: ["United States", "United Kingdom"] with metros: ["London Area, United Kingdom"] returns followers anywhere in the US plus London only.

How location filters combine: a follower in any of the countries, states or metros you pass is returned. The one exception: a country that has one of its own states or metros selected is not searched as a whole — only those states and metros are.

You pass	You get
`countries: ["United Kingdom"]`, `metros: ["London Area, United Kingdom"]`	London only
`countries: ["United States", "United Kingdom"]`, `metros: ["London Area, United Kingdom"]`	All of the US + London
`metros: ["San Francisco Bay Area", "Greater Boston"]`	Both metros
`states: ["Texas"]`, `metros: ["San Francisco Bay Area"]`	All of Texas + the Bay Area
`states: ["California"]`, `metros: ["San Francisco Bay Area"]`	All of California (the state already covers the metro)
`states: ["New Jersey"]`, `metros: ["New York City Metropolitan Area"]`	All of New Jersey + the New York and Connecticut parts of the metro

Metros are grouped by country, not by state, so a metro inside a selected state adds nothing. To get only a metro, select the metro without its state.

Webhooks: Optionally pass a webhookUrl to automatically receive one webhook per follower profile as it's scraped, plus a final completion callback when the job finishes. No separate flag needed — providing the URL enables per-result webhooks.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

curl --location 'https://dev.enrich.so/api/v3/company-follower' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "companyUrl": "https://linkedin.com/company/stripe", "max_limit": 500 }'

{ "success": true, "data": { "batchId": "665a1f4e2c3b7800129dce01", "message": "Job started. Use the progress endpoint to track status." }, "meta": { "requestId": "664f2b3c9a1e4d0012abcdef", "creditsReserved": 50000, "creditsPerItem": 100, "estimatedCredits": 50000 } }

Start company follower scrape

Request

Responses