curl --request POST \
--url https://api.leadsforge.ai/public/v1/company-followers/search \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"limit": 500,
"linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
"clientRequestID": "req_12345",
"countries": [
"United States",
"Germany"
],
"departments": [
"Engineering",
"Marketing"
],
"jobTitles": [
"Software Engineer",
"Product Manager"
],
"levels": [
"Senior",
"Director"
],
"metros": [
"San Francisco Bay Area",
"Amsterdam Area"
],
"states": [
"California",
"Bavaria"
],
"webhookURL": "https://example.com/webhooks/followers"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
limit: 500,
linkedinUrl: 'https://www.linkedin.com/company/salesforgeai',
clientRequestID: 'req_12345',
countries: ['United States', 'Germany'],
departments: ['Engineering', 'Marketing'],
jobTitles: ['Software Engineer', 'Product Manager'],
levels: ['Senior', 'Director'],
metros: ['San Francisco Bay Area', 'Amsterdam Area'],
states: ['California', 'Bavaria'],
webhookURL: 'https://example.com/webhooks/followers'
})
};
fetch('https://api.leadsforge.ai/public/v1/company-followers/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
limit: 500,
linkedinUrl: 'https://www.linkedin.com/company/salesforgeai',
clientRequestID: 'req_12345',
countries: ['United States', 'Germany'],
departments: ['Engineering', 'Marketing'],
jobTitles: ['Software Engineer', 'Product Manager'],
levels: ['Senior', 'Director'],
metros: ['San Francisco Bay Area', 'Amsterdam Area'],
states: ['California', 'Bavaria'],
webhookURL: 'https://example.com/webhooks/followers'
})
};
fetch('https://api.leadsforge.ai/public/v1/company-followers/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.leadsforge.ai/public/v1/company-followers/search';
const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
limit: 500,
linkedinUrl: 'https://www.linkedin.com/company/salesforgeai',
clientRequestID: 'req_12345',
countries: ['United States', 'Germany'],
departments: ['Engineering', 'Marketing'],
jobTitles: ['Software Engineer', 'Product Manager'],
levels: ['Senior', 'Director'],
metros: ['San Francisco Bay Area', 'Amsterdam Area'],
states: ['California', 'Bavaria'],
webhookURL: 'https://example.com/webhooks/followers'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.leadsforge.ai/public/v1/company-followers/search"
payload = {
"limit": 500,
"linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
"clientRequestID": "req_12345",
"countries": ["United States", "Germany"],
"departments": ["Engineering", "Marketing"],
"jobTitles": ["Software Engineer", "Product Manager"],
"levels": ["Senior", "Director"],
"metros": ["San Francisco Bay Area", "Amsterdam Area"],
"states": ["California", "Bavaria"],
"webhookURL": "https://example.com/webhooks/followers"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.leadsforge.ai/public/v1/company-followers/search"
payload := strings.NewReader("{\n \"limit\": 500,\n \"linkedinUrl\": \"https://www.linkedin.com/company/salesforgeai\",\n \"clientRequestID\": \"req_12345\",\n \"countries\": [\n \"United States\",\n \"Germany\"\n ],\n \"departments\": [\n \"Engineering\",\n \"Marketing\"\n ],\n \"jobTitles\": [\n \"Software Engineer\",\n \"Product Manager\"\n ],\n \"levels\": [\n \"Senior\",\n \"Director\"\n ],\n \"metros\": [\n \"San Francisco Bay Area\",\n \"Amsterdam Area\"\n ],\n \"states\": [\n \"California\",\n \"Bavaria\"\n ],\n \"webhookURL\": \"https://example.com/webhooks/followers\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<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://api.leadsforge.ai/public/v1/company-followers/search")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"limit\": 500,\n \"linkedinUrl\": \"https://www.linkedin.com/company/salesforgeai\",\n \"clientRequestID\": \"req_12345\",\n \"countries\": [\n \"United States\",\n \"Germany\"\n ],\n \"departments\": [\n \"Engineering\",\n \"Marketing\"\n ],\n \"jobTitles\": [\n \"Software Engineer\",\n \"Product Manager\"\n ],\n \"levels\": [\n \"Senior\",\n \"Director\"\n ],\n \"metros\": [\n \"San Francisco Bay Area\",\n \"Amsterdam Area\"\n ],\n \"states\": [\n \"California\",\n \"Bavaria\"\n ],\n \"webhookURL\": \"https://example.com/webhooks/followers\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.leadsforge.ai/public/v1/company-followers/search");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
request.AddJsonBody("{\n \"limit\": 500,\n \"linkedinUrl\": \"https://www.linkedin.com/company/salesforgeai\",\n \"clientRequestID\": \"req_12345\",\n \"countries\": [\n \"United States\",\n \"Germany\"\n ],\n \"departments\": [\n \"Engineering\",\n \"Marketing\"\n ],\n \"jobTitles\": [\n \"Software Engineer\",\n \"Product Manager\"\n ],\n \"levels\": [\n \"Senior\",\n \"Director\"\n ],\n \"metros\": [\n \"San Francisco Bay Area\",\n \"Amsterdam Area\"\n ],\n \"states\": [\n \"California\",\n \"Bavaria\"\n ],\n \"webhookURL\": \"https://example.com/webhooks/followers\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.leadsforge.ai/public/v1/company-followers/search",
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([
'limit' => 500,
'linkedinUrl' => 'https://www.linkedin.com/company/salesforgeai',
'clientRequestID' => 'req_12345',
'countries' => [
'United States',
'Germany'
],
'departments' => [
'Engineering',
'Marketing'
],
'jobTitles' => [
'Software Engineer',
'Product Manager'
],
'levels' => [
'Senior',
'Director'
],
'metros' => [
'San Francisco Bay Area',
'Amsterdam Area'
],
'states' => [
'California',
'Bavaria'
],
'webhookURL' => 'https://example.com/webhooks/followers'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.leadsforge.ai/public/v1/company-followers/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"limit\": 500,\n \"linkedinUrl\": \"https://www.linkedin.com/company/salesforgeai\",\n \"clientRequestID\": \"req_12345\",\n \"countries\": [\n \"United States\",\n \"Germany\"\n ],\n \"departments\": [\n \"Engineering\",\n \"Marketing\"\n ],\n \"jobTitles\": [\n \"Software Engineer\",\n \"Product Manager\"\n ],\n \"levels\": [\n \"Senior\",\n \"Director\"\n ],\n \"metros\": [\n \"San Francisco Bay Area\",\n \"Amsterdam Area\"\n ],\n \"states\": [\n \"California\",\n \"Bavaria\"\n ],\n \"webhookURL\": \"https://example.com/webhooks/followers\"\n}"
response = http.request(request)
puts response.read_body{
"clientRequestID": "req_12345",
"companyLogoUrl": "https://api.leadsforge.ai/images/AbC123xYz",
"companyName": "Salesforge",
"completedAt": "<string>",
"consumedCredits": 123,
"createdAt": "2026-03-18T12:00:00Z",
"error": "<string>",
"followerCount": 12345,
"jobID": "7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a",
"linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
"processed": 120,
"reservedCredits": 123,
"resultsURL": "/public/v1/company-followers/jobs/7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a/results",
"status": "in_progress",
"statusURL": "/public/v1/company-followers/jobs/7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a",
"total": 500,
"updatedAt": "2026-03-18T12:01:00Z",
"webhookURL": "https://example.com/webhooks/followers"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}Search company followers
Asynchronous. Starts a job that collects the followers of a LinkedIn company page (linkedinUrl) and returns 202 with the job; poll GET /company-followers/jobs/ or pass webhookURL, then page through GET /company-followers/jobs//results. limit is required, 1-50000 (larger values are rejected); a job can collect fewer followers than requested, since not every follower of a page can always be reached. countries, states, metros, jobTitles, departments and levels narrow the result and take values from the /company-followers/filters endpoints. The job creates a list named “Public API: Company Followers” in the app.
Consumes credits: your account’s followers price per follower collected. The job reserves the price for the smaller of limit and the page’s follower count, and at completion charges only the followers collected.
Idempotency-Key: a job with the same key in your account is returned as is, whatever the request body as long as it is valid, for as long as that job exists. A repeat does not count against the concurrent jobs limit, but it is still subject to the rate limit and can get 429; retry it with the same key.
Webhook: POST with JSON body when the job ends. A delivery that fails with a 5xx, 429 or network error is retried immediately and then redelivered in the background for up to 24h; other 4xx responses are not retried. Each attempt waits up to 8 seconds for a response. Redirects are not followed: a 3xx response is a failed delivery and is not retried. Every attempt carries the same X-Webhook-Delivery-Id header, equal to jobID, so repeated deliveries can be deduplicated. 2xx = delivered. Payload: jobID (string), status (completed|failed|no_results), linkedinUrl (string), companyName (string, omitted when unknown), followerCount (int), total (int), processed (int), error (string, present on failed and no_results). The webhook omits companyLogoUrl; fetch it from GET /company-followers/jobs/. webhookURL must be a public http or https URL with a domain name, not an IP address, or the request fails with 400; use https.
curl --request POST \
--url https://api.leadsforge.ai/public/v1/company-followers/search \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"limit": 500,
"linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
"clientRequestID": "req_12345",
"countries": [
"United States",
"Germany"
],
"departments": [
"Engineering",
"Marketing"
],
"jobTitles": [
"Software Engineer",
"Product Manager"
],
"levels": [
"Senior",
"Director"
],
"metros": [
"San Francisco Bay Area",
"Amsterdam Area"
],
"states": [
"California",
"Bavaria"
],
"webhookURL": "https://example.com/webhooks/followers"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
limit: 500,
linkedinUrl: 'https://www.linkedin.com/company/salesforgeai',
clientRequestID: 'req_12345',
countries: ['United States', 'Germany'],
departments: ['Engineering', 'Marketing'],
jobTitles: ['Software Engineer', 'Product Manager'],
levels: ['Senior', 'Director'],
metros: ['San Francisco Bay Area', 'Amsterdam Area'],
states: ['California', 'Bavaria'],
webhookURL: 'https://example.com/webhooks/followers'
})
};
fetch('https://api.leadsforge.ai/public/v1/company-followers/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
limit: 500,
linkedinUrl: 'https://www.linkedin.com/company/salesforgeai',
clientRequestID: 'req_12345',
countries: ['United States', 'Germany'],
departments: ['Engineering', 'Marketing'],
jobTitles: ['Software Engineer', 'Product Manager'],
levels: ['Senior', 'Director'],
metros: ['San Francisco Bay Area', 'Amsterdam Area'],
states: ['California', 'Bavaria'],
webhookURL: 'https://example.com/webhooks/followers'
})
};
fetch('https://api.leadsforge.ai/public/v1/company-followers/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.leadsforge.ai/public/v1/company-followers/search';
const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
limit: 500,
linkedinUrl: 'https://www.linkedin.com/company/salesforgeai',
clientRequestID: 'req_12345',
countries: ['United States', 'Germany'],
departments: ['Engineering', 'Marketing'],
jobTitles: ['Software Engineer', 'Product Manager'],
levels: ['Senior', 'Director'],
metros: ['San Francisco Bay Area', 'Amsterdam Area'],
states: ['California', 'Bavaria'],
webhookURL: 'https://example.com/webhooks/followers'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.leadsforge.ai/public/v1/company-followers/search"
payload = {
"limit": 500,
"linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
"clientRequestID": "req_12345",
"countries": ["United States", "Germany"],
"departments": ["Engineering", "Marketing"],
"jobTitles": ["Software Engineer", "Product Manager"],
"levels": ["Senior", "Director"],
"metros": ["San Francisco Bay Area", "Amsterdam Area"],
"states": ["California", "Bavaria"],
"webhookURL": "https://example.com/webhooks/followers"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.leadsforge.ai/public/v1/company-followers/search"
payload := strings.NewReader("{\n \"limit\": 500,\n \"linkedinUrl\": \"https://www.linkedin.com/company/salesforgeai\",\n \"clientRequestID\": \"req_12345\",\n \"countries\": [\n \"United States\",\n \"Germany\"\n ],\n \"departments\": [\n \"Engineering\",\n \"Marketing\"\n ],\n \"jobTitles\": [\n \"Software Engineer\",\n \"Product Manager\"\n ],\n \"levels\": [\n \"Senior\",\n \"Director\"\n ],\n \"metros\": [\n \"San Francisco Bay Area\",\n \"Amsterdam Area\"\n ],\n \"states\": [\n \"California\",\n \"Bavaria\"\n ],\n \"webhookURL\": \"https://example.com/webhooks/followers\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<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://api.leadsforge.ai/public/v1/company-followers/search")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"limit\": 500,\n \"linkedinUrl\": \"https://www.linkedin.com/company/salesforgeai\",\n \"clientRequestID\": \"req_12345\",\n \"countries\": [\n \"United States\",\n \"Germany\"\n ],\n \"departments\": [\n \"Engineering\",\n \"Marketing\"\n ],\n \"jobTitles\": [\n \"Software Engineer\",\n \"Product Manager\"\n ],\n \"levels\": [\n \"Senior\",\n \"Director\"\n ],\n \"metros\": [\n \"San Francisco Bay Area\",\n \"Amsterdam Area\"\n ],\n \"states\": [\n \"California\",\n \"Bavaria\"\n ],\n \"webhookURL\": \"https://example.com/webhooks/followers\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.leadsforge.ai/public/v1/company-followers/search");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
request.AddJsonBody("{\n \"limit\": 500,\n \"linkedinUrl\": \"https://www.linkedin.com/company/salesforgeai\",\n \"clientRequestID\": \"req_12345\",\n \"countries\": [\n \"United States\",\n \"Germany\"\n ],\n \"departments\": [\n \"Engineering\",\n \"Marketing\"\n ],\n \"jobTitles\": [\n \"Software Engineer\",\n \"Product Manager\"\n ],\n \"levels\": [\n \"Senior\",\n \"Director\"\n ],\n \"metros\": [\n \"San Francisco Bay Area\",\n \"Amsterdam Area\"\n ],\n \"states\": [\n \"California\",\n \"Bavaria\"\n ],\n \"webhookURL\": \"https://example.com/webhooks/followers\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.leadsforge.ai/public/v1/company-followers/search",
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([
'limit' => 500,
'linkedinUrl' => 'https://www.linkedin.com/company/salesforgeai',
'clientRequestID' => 'req_12345',
'countries' => [
'United States',
'Germany'
],
'departments' => [
'Engineering',
'Marketing'
],
'jobTitles' => [
'Software Engineer',
'Product Manager'
],
'levels' => [
'Senior',
'Director'
],
'metros' => [
'San Francisco Bay Area',
'Amsterdam Area'
],
'states' => [
'California',
'Bavaria'
],
'webhookURL' => 'https://example.com/webhooks/followers'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.leadsforge.ai/public/v1/company-followers/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"limit\": 500,\n \"linkedinUrl\": \"https://www.linkedin.com/company/salesforgeai\",\n \"clientRequestID\": \"req_12345\",\n \"countries\": [\n \"United States\",\n \"Germany\"\n ],\n \"departments\": [\n \"Engineering\",\n \"Marketing\"\n ],\n \"jobTitles\": [\n \"Software Engineer\",\n \"Product Manager\"\n ],\n \"levels\": [\n \"Senior\",\n \"Director\"\n ],\n \"metros\": [\n \"San Francisco Bay Area\",\n \"Amsterdam Area\"\n ],\n \"states\": [\n \"California\",\n \"Bavaria\"\n ],\n \"webhookURL\": \"https://example.com/webhooks/followers\"\n}"
response = http.request(request)
puts response.read_body{
"clientRequestID": "req_12345",
"companyLogoUrl": "https://api.leadsforge.ai/images/AbC123xYz",
"companyName": "Salesforge",
"completedAt": "<string>",
"consumedCredits": 123,
"createdAt": "2026-03-18T12:00:00Z",
"error": "<string>",
"followerCount": 12345,
"jobID": "7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a",
"linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
"processed": 120,
"reservedCredits": 123,
"resultsURL": "/public/v1/company-followers/jobs/7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a/results",
"status": "in_progress",
"statusURL": "/public/v1/company-followers/jobs/7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a",
"total": 500,
"updatedAt": "2026-03-18T12:01:00Z",
"webhookURL": "https://example.com/webhooks/followers"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}Authorizations
Headers
Body
Search request
Search request
Response
Job created
Was this page helpful?
