LinkedIn Company

Scrapes a LinkedIn company profile page and returns comprehensive company information including name, industry, description, employees, job listings, and more. Cost: 1 credit

Endpoint

POST /v1/crawl/linkedin/company

Request

Headers

Header	Required	Description
`Authorization`	Yes	`ApiKey ck_...`
`Content-Type`	Yes	`application/json`

Body

{
  "url": "https://www.linkedin.com/company/dataexpert-io/",
  "options": {
    "timeout": 30000,
    "includeJobs": true
  }
}

Parameters

Parameter	Type	Required	Default	Description
`url`	string	Yes	-	LinkedIn company URL (e.g., `https://www.linkedin.com/company/example/`)
`options.timeout`	number	No	30000	Page load timeout in milliseconds (5000-60000)
`options.includeJobs`	boolean	No	true	Whether to fetch job listings

Response

Success (200)

{
  "success": true,
  "data": {
    "company": {
      "name": "DataExpert",
      "industry": "Technology, Information and Internet",
      "location": "San Francisco, California",
      "followers": 15420,
      "slogan": "Building the future of data",
      "logoUrl": "https://media.licdn.com/...",
      "coverImageUrl": "https://media.licdn.com/...",
      "description": "DataExpert is a leading technology company...",
      "website": "https://dataexpert.io",
      "companySize": "51-200 employees",
      "headquarters": "San Francisco, California",
      "companyType": "Privately Held",
      "foundedYear": 2019,
      "specialties": ["Data Engineering", "Analytics", "Cloud"],
      "employees": [
        {
          "name": "John Doe",
          "photoUrl": "https://media.licdn.com/...",
          "linkedinUrl": "https://www.linkedin.com/in/johndoe/"
        }
      ],
      "locations": ["San Francisco, CA", "New York, NY"],
      "similarCompanies": [
        {
          "name": "TechCorp",
          "industry": "Software Development",
          "location": "Austin, Texas",
          "logoUrl": "https://media.licdn.com/...",
          "linkedinUrl": "https://www.linkedin.com/company/techcorp/"
        }
      ],
      "recentPosts": [
        {
          "content": "Excited to announce our new product launch!",
          "postUrl": "https://www.linkedin.com/feed/update/...",
          "timeAgo": "2d",
          "reactions": 156,
          "comments": 23,
          "imageUrls": ["https://media.licdn.com/..."]
        }
      ],
      "jobs": [
        {
          "title": "Senior Data Engineer",
          "jobUrl": "https://www.linkedin.com/jobs/view/...",
          "jobId": "3812345678",
          "location": "San Francisco, CA (Remote)",
          "postedTime": "1 week ago"
        }
      ],
      "linkedinUrl": "https://www.linkedin.com/company/dataexpert-io/",
      "scrapedAt": "2024-01-15T10:30:00.000Z"
    },
    "timing": {
      "total": 5234
    },
    "creditsUsed": 1,
    "creditsRemaining": 998
  }
}

Response Fields

Field	Type	Description
`company.name`	string	Company name
`company.industry`	string \| null	Company industry
`company.location`	string \| null	Company location
`company.followers`	number \| null	Number of LinkedIn followers
`company.slogan`	string \| null	Company slogan/tagline
`company.logoUrl`	string \| null	Company logo URL
`company.coverImageUrl`	string \| null	Cover image URL
`company.description`	string \| null	Company description
`company.website`	string \| null	Company website URL
`company.companySize`	string \| null	Company size range
`company.headquarters`	string \| null	Headquarters location
`company.companyType`	string \| null	Type of company (Public, Private, etc.)
`company.foundedYear`	number \| null	Year company was founded
`company.specialties`	string[]	List of company specialties
`company.employees`	array	Featured employees
`company.locations`	string[]	All company locations
`company.similarCompanies`	array	Similar companies on LinkedIn
`company.recentPosts`	array	Recent company posts
`company.jobs`	array	Current job listings (if `includeJobs` is true)
`company.linkedinUrl`	string	Original LinkedIn URL
`company.scrapedAt`	string	ISO timestamp of when data was scraped
`timing.total`	number	Total request time in milliseconds
`creditsUsed`	number	Credits charged (always 1)
`creditsRemaining`	number	Your remaining credit balance

Examples

Basic Request

curl -X POST https://api.crawlkit.com/v1/crawl/linkedin/company \
  -H "Authorization: ApiKey ck_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.linkedin.com/company/google/"}'

Without Job Listings

curl -X POST https://api.crawlkit.com/v1/crawl/linkedin/company \
  -H "Authorization: ApiKey ck_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/company/google/",
    "options": {
      "includeJobs": false
    }
  }'

With Increased Timeout

curl -X POST https://api.crawlkit.com/v1/crawl/linkedin/company \
  -H "Authorization: ApiKey ck_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/company/microsoft/",
    "options": {
      "timeout": 60000
    }
  }'

Error Responses

Invalid URL (400)

{
  "success": false,
  "error": {
    "code": "INVALID_URL",
    "message": "URL must be a valid LinkedIn company URL"
  }
}

Unauthorized (401)

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}

Insufficient Credits (402)

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "You have 0 credits remaining"
  }
}

Timeout (408)

{
  "success": false,
  "error": {
    "code": "TIMEOUT",
    "message": "Page load timed out after 30000ms"
  }
}

Scrape Failed (502)

{
  "success": false,
  "error": {
    "code": "CRAWL_FAILED",
    "message": "Failed to scrape LinkedIn company page"
  }
}

Use Cases

Lead Generation

Gather company data for B2B sales prospecting

Market Research

Analyze competitors and industry trends

Recruitment

Find companies hiring in your field

Investment Research

Research companies for investment decisions

Tips

Use the correct URL format

LinkedIn company URLs should follow the format: https://www.linkedin.com/company/company-slug/. The trailing slash is optional.

Disable jobs for faster response

If you don’t need job listings, set includeJobs: false to speed up the scraping process.

Handle null values

Many fields can be null if the company hasn’t provided that information. Always check for null values in your code.

Overview

Crawl Endpoints

Endpoint

Request

Headers

Body

Parameters

Response

Success (200)

Response Fields

Examples

Basic Request

Without Job Listings

With Increased Timeout

Error Responses

Invalid URL (400)

Unauthorized (401)

Insufficient Credits (402)

Timeout (408)

Scrape Failed (502)

Use Cases

Lead Generation

Market Research

Recruitment

Investment Research

Tips

Overview

Crawl Endpoints

​Endpoint

​Request

​Headers

​Body

​Parameters

​Response

​Success (200)

​Response Fields

​Examples

​Basic Request

​Without Job Listings

​With Increased Timeout

​Error Responses

​Invalid URL (400)

​Unauthorized (401)

​Insufficient Credits (402)

​Timeout (408)

​Scrape Failed (502)

​Use Cases

Lead Generation

Market Research

Recruitment

Investment Research

​Tips

Endpoint

Request

Headers

Body

Parameters

Response

Success (200)

Response Fields

Examples

Basic Request

Without Job Listings

With Increased Timeout

Error Responses

Invalid URL (400)

Unauthorized (401)

Insufficient Credits (402)

Timeout (408)

Scrape Failed (502)

Use Cases

Tips