Skip to main content
POST
Preview competitor followers
Find out how many people follow a company’s LinkedIn page, and what extracting them would cost, before spending any credits. This is the free first step of the two-step competitor-followers signal:
  1. Preview (this endpoint) returns the company, its follower count and the price. No credits.
  2. Extract starts an async extraction of the followers into a search. Spends enrichment credits.

Credits and requirements

  • Credits: free
  • Requires a connected LinkedIn account: the follower count comes from LinkedIn. Without one the request returns 422.
  • Authentication: standard v2 scheme (X-API-KEY)

The company URL

company_linkedin_url is the company’s LinkedIn page: https://www.linkedin.com/company/<name>, or /school/ and /showcase/ pages. A numeric https://www.linkedin.com/company/<id> URL works too when your LinkedIn account has Sales Navigator, which turns the id into the page’s name. A page LinkedIn does not know returns 404.

Accepted keys

The body takes company_linkedin_url. The extract-only keys limit, persona, webhook_url and name are accepted and ignored, so the same body works for the preview and the extract call. Any other key is rejected with 422.

Example request

Example response

estimated_credits is the price of extracting every follower: max(follower_count, minimum_credits).

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

Accepted and ignored.

Required range: x >= 1
persona
string<uuid>

Accepted and ignored.

webhook_url
string<uri>

Accepted and ignored.

name
string

Accepted and ignored.

Response

The company and the price of extracting its followers

company
object
required

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

follower_count
integer
required

People following the company page on LinkedIn.

Example:

4210

credits_per_follower
integer
required

Enrichment credits charged per extracted follower.

Example:

1

minimum_credits
integer
required

Minimum charge per extraction, whatever the number of followers.

Example:

1000

estimated_credits
integer
required

Credits to extract every follower: max(follower_count, minimum_credits).

Example:

4210