LinkedIn Company Scraper​

Overview

The LinkedIn Company Scraper endpoint extracts public organizational data directly from any LinkedIn company page. Pass a LinkedIn URL, get back a full company profile — description, headcount, specialties, office locations, recent posts, and similar companies.

Who Is This For?

Role	Use Case
Marketers	Enrich campaign targeting with up-to-date company descriptions, size, and specialties pulled straight from LinkedIn.
Lead Generation Teams	Qualify prospects by validating company size, industry, and location before handing off to sales.
Developers	Integrate LinkedIn company data into CRMs, sales intelligence tools, or internal enrichment pipelines.

What You Can Build

• CRM enrichment pipeline — automatically populate or refresh company records with live LinkedIn data whenever a new account is added.
• Competitive intelligence tool — monitor competitor profiles, track recent updates, and surface similar companies in your space.
• Lead scoring system — use headcount, industry, and specialties to score and prioritize inbound leads automatically.
• Account research assistant — pull full company context before a sales call without manual LinkedIn browsing.
• ABM target list builder — combine with the Company Directory endpoint to discover companies, then enrich each one with their full LinkedIn profile.

Endpoint

POST https://api.scravity.com/v1/companies/linkedin

Cost: 2 credits per request (live) · 1 credit per request (cached)  ·  Avg. Response Time: ~4s

Authentication

Include your API key as a Bearer token in every request.

Authorization: Bearer YOUR_API_KEY

Request Body

Parameter	Type	Required	Description
linkedin_company_page	string	Yes	Full URL of the LinkedIn company page (e.g., https://www.linkedin.com/company/microsoft/).

Code Examples

cURL

curl -X POST https://api.scravity.com/v1/companies/linkedin \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "linkedin_company_page": "https://www.linkedin.com/company/microsoft/"
  }'

Python

import requests

url = "https://api.scravity.com/v1/companies/linkedin"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "linkedin_company_page": "https://www.linkedin.com/company/microsoft/"
}

r = requests.post(url, json=payload, headers=headers)
print(r.json())

JavaScript

const res = await fetch("https://api.scravity.com/v1/companies/linkedin", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    linkedin_company_page: "https://www.linkedin.com/company/microsoft/"
  })
});

const data = await res.json();
console.log(data);

Response Format

Success (200)

{
  "company_name": "Microsoft",
  "headline": "Technology Solutions",
  "location_and_followers": "Redmond, Washington · 10M followers",
  "slogan": "Empower every person and every organization on the planet to achieve more.",
  "about_us": "Every company has a mission...",
  "metadata": {
    "website": "https://microsoft.com",
    "industry": "Software Development",
    "company_size": "10,001+ employees",
    "headquarters": "Redmond, WA",
    "company_type": "Public Company",
    "founded": "1975",
    "specialties": "Business Software, Developer Tools, Cloud Computing, AI"
  },
  "locations": [
    "One Microsoft Way, Redmond, WA 98052, US"
  ],
  "recent_updates": [
    {
      "time_posted": "2d",
      "content": "Join us for the next Microsoft Build..."
    }
  ],
  "similar_pages": [
    { "name": "Google", "industry": "Software Development" },
    { "name": "Apple", "industry": "Computers and Electronics Manufacturing" }
  ]
}

No Profile Found (404)

{
  "error": "No company profiles found for the provided link",
  "details": ["The provided LinkedIn URL does not exist or is not a public company page."]
}

Insufficient Credits (402)

{
  "error": "Insufficient credits",
  "details": ["You need at least 2 credits to perform this action. Current balance: 0."]
}

Validation Error (422)

{
  "detail": [
    {
      "loc": ["body", "linkedin_company_page"],
      "msg": "Field required",
      "type": "value_error.missing"
    }
  ]
}

Credits

Result	Cost
Live extraction	2 credits
Cached result	1 credit
No profile found (404)	0 credits

Rate Limits

Window	Limit
Per second	20 requests
Per minute	1,000 requests

Tips

• Always use the full canonical URL including the trailing slash — https://www.linkedin.com/company/microsoft/ not just linkedin.com/microsoft.
• Re-requesting the same company page costs only 1 credit when cached — safe to refresh records periodically without doubling costs.
• The similar_pages field is a built-in source for discovering competitor or adjacent companies to add to your pipeline.
• Pair with Company Email Finder to go from a LinkedIn profile straight to verified contact emails in one workflow.
• Check your balance with GET /v1/credits before running bulk enrichment jobs.