LinkedIn Company Bulk API
Returns several LinkedIn company pages in one call, each with the same profile and About tab fields company returns, and names any company it could not find.
GET /v1/linkedin/company/bulkLast updated November 2026Maintained by the SocialCrawl team
When to use the LinkedIn Company Bulk API
Use it to enrich a list of companies at once instead of calling company for each; pass page URLs, slugs or numeric ids.
From the API reference
Returns up to 25 LinkedIn company pages in one call, each as the same canonical author /v1/linkedin/company returns: author.id (the numeric company id), username, display_name, bio, avatar_url, followers, location, url and the About tab in author.ext, including company_type, tagline, founded_year, public_phone, headquarters and locations. author.verified and author.ext.page_active are null on this endpoint, each office's lat_long carries null latitude and longitude, and hashtag follower_count values are null. Companies come back in the order you sent them; duplicates are merged. A company that has no page is left out and named on data._warnings as not found, and costs nothing. A company that could not be fetched just now is left out too, named on data._warnings as one to send again, and costs nothing; if none could be fetched for that reason the call answers 503 at no charge, so send the same request again. data.total is the number of companies returned.
Searching 69 platforms in parallel
What can you do with the Company Bulk API?
The Company Bulk endpoint gives you structured LinkedIn data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
# GET /v1/linkedin/company/bulk: Metered: holds 15 credits per call up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 60: the API's own time limit for this endpoint.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 60 --retry 3 -o response.json \
-H "x-api-key: YOUR_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://www.socialcrawl.dev/v1/linkedin/company/bulk?companies=microsoft%2Cstripe%2Czzq-not-a-company-99871" && cat response.json# GET /v1/linkedin/company/bulk: Metered: holds 15 credits per call up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid
import requests
API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 60 # the API's own time limit for this endpoint.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/linkedin/company/bulk"
def backoff(attempt):
# Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
return 2 ** attempt * (0.5 + random.random() / 2)
def socialcrawl(params):
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
idempotency_key = str(uuid.uuid4())
for attempt in range(MAX_RETRIES + 1):
try:
res = requests.get(
URL,
params=params,
headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
timeout=TIMEOUT_S,
)
body = res.json()
except (requests.RequestException, ValueError):
# A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if attempt == MAX_RETRIES:
raise
time.sleep(backoff(attempt))
continue
if body["success"]:
return body
error = body["error"]
# Branch on error["type"], never on the message text.
if error["type"] == "RESOURCE_NOT_FOUND":
return None # refunded: nothing to read
retry_after = res.headers.get("Retry-After")
# SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
# Retry-After (seconds) wins; otherwise back off.
time.sleep(float(retry_after) if retry_after else backoff(attempt))
params = {
"companies": "microsoft,stripe,zzq-not-a-company-99871",
}
body = socialcrawl(params)
if body is not None:
print(body["data"])// GET /v1/linkedin/company/bulk: Metered: holds 15 credits per call up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 60_000; // the API's own time limit for this endpoint.
const MAX_RETRIES = 3;
type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
| { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
| { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);
async function socialcrawl(url: URL) {
// One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
const idempotencyKey = crypto.randomUUID();
for (let attempt = 0; ; attempt++) {
let res: Response;
let body: SocialCrawlResponse;
try {
res = await fetch(url, {
headers: {
"x-api-key": API_KEY,
"Idempotency-Key": idempotencyKey,
},
signal: AbortSignal.timeout(TIMEOUT_MS),
});
body = (await res.json()) as SocialCrawlResponse;
} catch (error) {
// A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if (attempt >= MAX_RETRIES) throw error;
await sleep(backoffMs(attempt));
continue;
}
if (body.success) return body;
// Branch on error.type, never on the message text.
if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
const retryAfter = res.headers.get("Retry-After");
// SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
}
// Retry-After (seconds) wins; otherwise back off.
await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
}
}
const url = new URL("https://www.socialcrawl.dev/v1/linkedin/company/bulk");
url.searchParams.set("companies", "microsoft,stripe,zzq-not-a-company-99871");
const body = await socialcrawl(url);
if (body) console.log(body.data);Parameters
| Parameter | Required | Description |
|---|---|---|
| companies | Yes | 1 to 25 LinkedIn companies, comma separated: company page URLs (https://www.linkedin.com/company/microsoft/), slugs (`microsoft`) or numeric company ids (`1035`). Duplicates are merged before you are charged. |
What does the LinkedIn Company Bulk API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "linkedin",
"endpoint": "/v1/linkedin/company/bulk",
"data": {
"items": [
{
"author": {
"id": "1035",
"username": "microsoft",
"display_name": "Microsoft",
"avatar_url": "https://media.licdn.com/dms/image/v2/D560BAQH32RJQCl3dDQ/company-logo_400_400/B56ZYQ0mrGGoAc-/0/1744038948046/microsoft_logo?e=1795046400&v=beta&t=PF-VM3736hLjlyfPrh1IO6a9gyDDkiLQI3eeOrLUhKo",
"bio": "Every company has a mission. What's ours? To empower every person and every organization to achieve more. We believe technology can and should be a force for good and that meaningful innovation contributes to a brighter world in the future and today. Our culture doesn’t just encourage curiosity; it embraces it. Each day we make progress together by showing up as our authentic selves. We show up with a learn-it-all mentality. We show up cheering on others, knowing their success doesn't diminish our own. We show up every day open to learning our own biases, changing our behavior, and inviting in differences. Because impact matters. \n\nMicrosoft operates in 190 countries and is made up of approximately 228,000 passionate employees worldwide.",
"verified": null,
"followers": 29432919,
"following": null,
"posts_count": null,
"likes_count": null,
"url": "https://www.linkedin.com/company/microsoft",
"location": "Redmond, Washington, US",
"private": null,
"joined_at": null,
"ext": {
"country": "US",
"country_name": "United States",
"public_phone": null,
"website": "https://news.microsoft.com/",
"cover_url": "https://media.licdn.com/dms/image/v2/D4E3DAQGWOa_gAs1qXg/image-scale_325_1920/B4EZ8ZTX5SJEAI-/0/1782835937311/microsoft_cover?e=1794294000&v=beta&t=xVXF3b1APEJquEBWepI8ghmR6E1mUJuvllQOYS44k98",
"page_active": null,
"employee_count": 231131,
"employee_count_range": {
"start": 10001,
"end": null
},
"founded_year": null,
"company_type": "Public Company",
"tagline": null,
"specialities": [
"Business Software",
"Developer Tools"
],
"industries": [
"Software Development"
],
"headquarters": {
"country": "US",
"city": "Redmond",
"geographic_area": "Washington",
"line1": "[address redacted]",
"postal_code": "98052"
},
"locations": [
{
"name": "Bratislava",
"address": {
"country": "SK",
"city": "Bratislava",
"geographic_area": null,
"line1": "Pradiareň 1900",
"line2": "Svätoplukova 2A",
"postal_code": "821 08"
},
"lat_long": {
"latitude": null,
"longitude": null
}
},
{
"name": "Reading",
"address": {
"country": "GB",
"city": "Reading",
"geographic_area": "Berkshire",
"line1": "Thames Valley Park Drive",
"postal_code": "RG6 1WG"
},
"lat_long": {
"latitude": null,
"longitude": null
}
}
],
"hashtags": [
{
"name": "#microsoftlife",
"follower_count": null
},
{
"name": "#microsoft",
"follower_count": null
}
],
"funding": {
"last_funding_round": {
"money_raised": {},
"announced_on": {}
}
}
}
}
},
{
"author": {
"id": "2135371",
"username": "stripe",
"display_name": "Stripe",
"avatar_url": "https://media.licdn.com/dms/image/v2/D560BAQE2ZfJyfn-VCg/company-logo_400_400/B56ZlyKwpUKIAY-/0/1758557047806/stripe_logo?e=1795046400&v=beta&t=6f6gb19gRWloVgTRfECk9Gya0CZGSubReG-JfL6pLJ8",
"bio": "Stripe builds programmable financial services. Millions of companies—from the world’s largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headquartered in San Francisco and Dublin, the company aims to increase the GDP of the internet.",
"verified": null,
"followers": 1801907,
"following": null,
"posts_count": null,
"likes_count": null,
"url": "https://www.linkedin.com/company/stripe",
"location": "South San Francisco, California, US",
"private": null,
"joined_at": null,
"ext": {
"country": "US",
"country_name": "United States",
"public_phone": null,
"website": "https://stripe.com",
"cover_url": "https://media.licdn.com/dms/image/v2/D563DAQFt98MykXcktg/image-scale_191_1128/B56Z352EMMKIAY-/0/1778013193531/stripe_cover?e=1794294000&v=beta&t=gUiqwP7aRqFi7sscOY00fgWytlgJtcLaZv_IRmIAn1Q",
"page_active": null,
"employee_count": 16694,
"employee_count_range": {
"start": 5001,
"end": 10000
},
"founded_year": 2010,
"company_type": "Privately Held",
"tagline": "Help increase the GDP of the internet.",
"specialities": [],
"industries": [
"Technology, Information and Internet"
],
"headquarters": {
"country": "US",
"city": "South San Francisco",
"geographic_area": "California",
"line1": "[address redacted]",
"postal_code": "94080"
},
"locations": [
{
"name": "Tokyo",
"address": {
"country": "JP",
"city": "Tokyo",
"geographic_area": "Shibuya-ku",
"line1": "1-5-8 Jingumae",
"postal_code": "150-0001"
},
"lat_long": {
"latitude": null,
"longitude": null
}
},
{
"name": "Paris",
"address": {
"country": "FR",
"city": "Paris",
"geographic_area": "Ile-de-France",
"line1": "10, Boulevard Haussmann",
"postal_code": "75009"
},
"lat_long": {
"latitude": null,
"longitude": null
}
}
],
"hashtags": [
{
"name": "#stripe",
"follower_count": null
}
],
"funding": {
"last_funding_round": {
"money_raised": {},
"announced_on": {}
}
}
}
}
}
],
"total": 2,
"dropped": 0,
"_warnings": [
"No LinkedIn company page was found for: zzq-not-a-company-99871"
]
},
"credits_used": 10,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 2,
"typical_page_size": null,
"next_page_credits": null
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-11-03T06:52:48.111Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the LinkedIn Company Bulk API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 69 platforms covering 10B+ monthly active users.
One schema, every platform
Query 69 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usWhat does the LinkedIn Company Bulk API return?
When should I use the LinkedIn Company Bulk endpoint?
How much does the LinkedIn Company Bulk API cost?
What parameters does the LinkedIn Company Bulk API need?
How do I call the LinkedIn Company Bulk API?
Ask AI about SocialCrawl
Ready to scrape LinkedIn Company Bulk data?
Get your API key and start pulling LinkedIn data in under 60 seconds.
