Extract competitor followers
curl --request POST \
--url https://app.pipecorn.com/api/v2/intents/leads/competitor_followers \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"company_linkedin_url": "https://www.linkedin.com/company/pipecorn",
"limit": 2000,
"persona": "550e8400-e29b-41d4-a716-446655440000",
"webhook_url": "https://your-company.com/webhooks/competitor-followers",
"name": "Followers of Pipecorn - Q4"
}
'import requests
url = "https://app.pipecorn.com/api/v2/intents/leads/competitor_followers"
payload = {
"company_linkedin_url": "https://www.linkedin.com/company/pipecorn",
"limit": 2000,
"persona": "550e8400-e29b-41d4-a716-446655440000",
"webhook_url": "https://your-company.com/webhooks/competitor-followers",
"name": "Followers of Pipecorn - Q4"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
company_linkedin_url: 'https://www.linkedin.com/company/pipecorn',
limit: 2000,
persona: '550e8400-e29b-41d4-a716-446655440000',
webhook_url: 'https://your-company.com/webhooks/competitor-followers',
name: 'Followers of Pipecorn - Q4'
})
};
fetch('https://app.pipecorn.com/api/v2/intents/leads/competitor_followers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.pipecorn.com/api/v2/intents/leads/competitor_followers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'company_linkedin_url' => 'https://www.linkedin.com/company/pipecorn',
'limit' => 2000,
'persona' => '550e8400-e29b-41d4-a716-446655440000',
'webhook_url' => 'https://your-company.com/webhooks/competitor-followers',
'name' => 'Followers of Pipecorn - Q4'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.pipecorn.com/api/v2/intents/leads/competitor_followers"
payload := strings.NewReader("{\n \"company_linkedin_url\": \"https://www.linkedin.com/company/pipecorn\",\n \"limit\": 2000,\n \"persona\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"webhook_url\": \"https://your-company.com/webhooks/competitor-followers\",\n \"name\": \"Followers of Pipecorn - Q4\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.pipecorn.com/api/v2/intents/leads/competitor_followers")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"company_linkedin_url\": \"https://www.linkedin.com/company/pipecorn\",\n \"limit\": 2000,\n \"persona\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"webhook_url\": \"https://your-company.com/webhooks/competitor-followers\",\n \"name\": \"Followers of Pipecorn - Q4\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.pipecorn.com/api/v2/intents/leads/competitor_followers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"company_linkedin_url\": \"https://www.linkedin.com/company/pipecorn\",\n \"limit\": 2000,\n \"persona\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"webhook_url\": \"https://your-company.com/webhooks/competitor-followers\",\n \"name\": \"Followers of Pipecorn - Q4\"\n}"
response = http.request(request)
puts response.read_body{
"message": "Competitor followers extraction started. Results land on the search once the scrape finishes.",
"search_id": "8e1dcba0-f0bb-4071-99fc-f18ba6559ccc",
"company": {
"name": "Pipecorn",
"linkedin_id": "12345678",
"linkedin_url": "https://www.linkedin.com/company/pipecorn",
"industry": "Software Development",
"employee_range": "11-50",
"location": "Paris, Île-de-France"
},
"follower_count": 4210,
"expected_profiles_count": 2000,
"credits_reserved": 2000,
"status_url": "https://app.pipecorn.com/api/v2/searches/8e1dcba0-f0bb-4071-99fc-f18ba6559ccc"
}Signals
Competitor followers
Extract the people who follow a company page on LinkedIn
POST
/
intents
/
leads
/
competitor_followers
Extract competitor followers
curl --request POST \
--url https://app.pipecorn.com/api/v2/intents/leads/competitor_followers \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"company_linkedin_url": "https://www.linkedin.com/company/pipecorn",
"limit": 2000,
"persona": "550e8400-e29b-41d4-a716-446655440000",
"webhook_url": "https://your-company.com/webhooks/competitor-followers",
"name": "Followers of Pipecorn - Q4"
}
'import requests
url = "https://app.pipecorn.com/api/v2/intents/leads/competitor_followers"
payload = {
"company_linkedin_url": "https://www.linkedin.com/company/pipecorn",
"limit": 2000,
"persona": "550e8400-e29b-41d4-a716-446655440000",
"webhook_url": "https://your-company.com/webhooks/competitor-followers",
"name": "Followers of Pipecorn - Q4"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
company_linkedin_url: 'https://www.linkedin.com/company/pipecorn',
limit: 2000,
persona: '550e8400-e29b-41d4-a716-446655440000',
webhook_url: 'https://your-company.com/webhooks/competitor-followers',
name: 'Followers of Pipecorn - Q4'
})
};
fetch('https://app.pipecorn.com/api/v2/intents/leads/competitor_followers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.pipecorn.com/api/v2/intents/leads/competitor_followers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'company_linkedin_url' => 'https://www.linkedin.com/company/pipecorn',
'limit' => 2000,
'persona' => '550e8400-e29b-41d4-a716-446655440000',
'webhook_url' => 'https://your-company.com/webhooks/competitor-followers',
'name' => 'Followers of Pipecorn - Q4'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.pipecorn.com/api/v2/intents/leads/competitor_followers"
payload := strings.NewReader("{\n \"company_linkedin_url\": \"https://www.linkedin.com/company/pipecorn\",\n \"limit\": 2000,\n \"persona\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"webhook_url\": \"https://your-company.com/webhooks/competitor-followers\",\n \"name\": \"Followers of Pipecorn - Q4\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.pipecorn.com/api/v2/intents/leads/competitor_followers")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"company_linkedin_url\": \"https://www.linkedin.com/company/pipecorn\",\n \"limit\": 2000,\n \"persona\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"webhook_url\": \"https://your-company.com/webhooks/competitor-followers\",\n \"name\": \"Followers of Pipecorn - Q4\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.pipecorn.com/api/v2/intents/leads/competitor_followers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"company_linkedin_url\": \"https://www.linkedin.com/company/pipecorn\",\n \"limit\": 2000,\n \"persona\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"webhook_url\": \"https://your-company.com/webhooks/competitor-followers\",\n \"name\": \"Followers of Pipecorn - Q4\"\n}"
response = http.request(request)
puts response.read_body{
"message": "Competitor followers extraction started. Results land on the search once the scrape finishes.",
"search_id": "8e1dcba0-f0bb-4071-99fc-f18ba6559ccc",
"company": {
"name": "Pipecorn",
"linkedin_id": "12345678",
"linkedin_url": "https://www.linkedin.com/company/pipecorn",
"industry": "Software Development",
"employee_range": "11-50",
"location": "Paris, Île-de-France"
},
"follower_count": 4210,
"expected_profiles_count": 2000,
"credits_reserved": 2000,
"status_url": "https://app.pipecorn.com/api/v2/searches/8e1dcba0-f0bb-4071-99fc-f18ba6559ccc"
}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
limitof 300 still costs 1,000 credits. limitis 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
402withcode: "insufficient_credits"and atop_up_url, and no extraction starts. See Credit and limit errors.
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 extractpersona: a persona UUID, to keep only the followers who match its Sales Navigator searchwebhook_url: where the leads are POSTed when the extraction finishesname: the name of the lead list, up to 75 characters. Defaults toFollowers of <company>.
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 asearch_id right away:
- Poll
status_url, which isGET /searches/{id}, untilstatusisfinished. 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.
Example request
{
"company_linkedin_url": "https://www.linkedin.com/company/pipecorn",
"limit": 2000,
"webhook_url": "https://your-company.com/webhooks/competitor-followers"
}
Example response
{
"message": "Competitor followers extraction started. Results land on the search once the scrape finishes.",
"search_id": "8e1dcba0-f0bb-4071-99fc-f18ba6559ccc",
"company": {
"name": "Pipecorn",
"linkedin_id": "12345678",
"linkedin_url": "https://www.linkedin.com/company/pipecorn",
"industry": "Software Development",
"employee_range": "11-50",
"location": "Paris, Île-de-France"
},
"follower_count": 4210,
"expected_profiles_count": 2000,
"credits_reserved": 2000,
"status_url": "https://app.pipecorn.com/api/v2/searches/8e1dcba0-f0bb-4071-99fc-f18ba6559ccc"
}
Body
application/json
Response
Extraction started
Was this page helpful?