100 free credits. No credit card required.Start building
Logo
LinkedIn logo
100 free credits. No credit card required

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/bulk

Last 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

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
LinkedIn API

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

ParameterRequiredDescription
companiesYes1 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.
Example Response

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.

API Details

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

Why SocialCrawl

Why use SocialCrawl for LinkedIn Company Bulk data?

We handle the complexity of LinkedIn data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

Developer First

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()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 69 platforms
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the LinkedIn Company Bulk API return?
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. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.
When should I use the LinkedIn Company Bulk endpoint?
Use it to enrich a list of companies at once instead of calling company for each; pass page URLs, slugs or numeric ids.
How much does the LinkedIn Company Bulk API cost?
The price depends on the request, from 5 to 125 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription.
What parameters does the LinkedIn Company Bulk API need?
The one required parameter is companies (1 to 25 LinkedIn companies, comma separated: company page URLs, slugs or numeric company ids).
How do I call the LinkedIn Company Bulk API?
Send a GET request to https://www.socialcrawl.dev/v1/linkedin/company/bulk?companies=microsoft%2Cstripe%2Czzq-not-a-company-99871 with your API key in the x-api-key header. An Authorization: Bearer header works too.

Ask AI about SocialCrawl

Ready to scrape LinkedIn Company Bulk data?

Get your API key and start pulling LinkedIn data in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown