Skip to main content
POST
Extract competitor followers
Extract the people who follow a company’s LinkedIn page, typically a competitor’s, into a lead list. Run the preview first to see the follower count and the price for free. This signal is part of the Growth plan. Below it, the request is refused with 403 and {"error": "This signal is part of the Growth plan. Upgrade to save these leads to a list."}.

Credits

  • 1 enrichment credit per follower, with a minimum of 1,000 credits per extraction. A limit of 300 still costs 1,000 credits.
  • limit is capped to the company’s follower count, and you are charged for that capped count.
  • The credits are reserved when the request is accepted. When fewer followers come back than reserved, the difference is refunded.
  • Without enough credits the request returns 402 with code: "insufficient_credits" and a top_up_url, and no extraction starts. See Credit and limit errors.
The endpoint is exempt from request rate limiting: the credit balance is its own throttle. It requires a connected LinkedIn account.

Body

  • company_linkedin_url (required): the company’s LinkedIn page, with its name (https://www.linkedin.com/company/<name>) or numeric id (with Sales Navigator)
  • limit (required): how many followers to extract
  • persona: a persona UUID, to keep only the followers who match its Sales Navigator search
  • webhook_url: where the leads are POSTed when the extraction finishes
  • name: the name of the lead list, up to 75 characters. Defaults to Followers of <company>.
Any other key is rejected with 422.

Getting the results

The extraction runs outside LinkedIn and takes from several minutes to a few hours, depending on the number of followers. The response returns a search_id right away:
  • Poll status_url, which is GET /searches/{id}, until status is finished. It then returns the leads, paginated.
  • With webhook_url, the leads are also POSTed there once the extraction finishes, in the same payload as other searches.
The list also appears in the app, under My lists, once the API / MCP toggle is on.

Example request

Example response

Authorizations

X-API-KEY
string
header
required

Body

application/json
company_linkedin_url
string<uri>
required

LinkedIn company page URL of the competitor: /company/<name>, /school/<name> or /showcase/<name>. A numeric /company/<id> URL works when the LinkedIn account has Sales Navigator.

Example:

"https://www.linkedin.com/company/pipecorn"

limit
integer
required

Number of followers to extract. Capped to the company's follower count. Any value below 1,000 is still charged 1,000 credits.

Required range: x >= 1
Example:

2000

persona
string<uuid>

Persona UUID: keep only the followers who match its Sales Navigator search.

Example:

"550e8400-e29b-41d4-a716-446655440000"

webhook_url
string<uri>

URL that receives the leads when the extraction finishes, in the same payload as other searches.

Example:

"https://your-company.com/webhooks/competitor-followers"

name
string

Name of the lead list. Defaults to Followers of <company>.

Maximum string length: 75
Example:

"Followers of Pipecorn - Q4"

Response

Extraction started

message
string
required
Example:

"Competitor followers extraction started. Results land on the search once the scrape finishes."

search_id
string<uuid>
required

ID of the search the followers land on.

Example:

"8e1dcba0-f0bb-4071-99fc-f18ba6559ccc"

company
object
required

The company LinkedIn returned. Fields LinkedIn leaves blank are omitted.

follower_count
integer
required
Example:

4210

expected_profiles_count
integer
required

Followers that will be extracted: limit, capped to follower_count.

Example:

2000

credits_reserved
integer
required

Credits reserved for this extraction: max(expected_profiles_count, 1000).

Example:

2000

status_url
string<uri>
required

Where to poll the extraction: GET /searches/{id}. Same value as the Location header.

Example:

"https://app.pipecorn.com/api/v2/searches/8e1dcba0-f0bb-4071-99fc-f18ba6559ccc"