Docs · LinkedIn company page

LinkedIn company page

A company's public page: overview, size, industry, headquarters and latest updates.

1 credit per callFresh within 1 hourMCP tool: linkedin_company

GEThttps://api.lurkapi.com/v1/linkedin/company

When to use this

Use it to look up a company: tagline, About text, website, industry, size, headquarters, specialties and latest updates. Pass its LinkedIn page URL. Its id filters job search (linkedin_search_jobs) to this company.

You get the public page a logged-out visitor sees, and missing fields are null. Employee profiles, funding details and the full About tab aren't included. If LinkedIn asks us to sign in or shows a challenge, the call fails with upstream_error (free) instead of returning an empty company.

Example request

Copy one and replace YOUR_API_KEY with your API key (get one free). The code versions read the key from the LURKAPI_API_KEY environment variable instead.

curl "https://api.lurkapi.com/v1/linkedin/company?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fhubspot%2F" \
  -H "x-api-key: YOUR_API_KEY"

Paste it into a terminal, with your key in place of YOUR_API_KEY.

const params = new URLSearchParams({
  url: "https://www.linkedin.com/company/hubspot/",
});
const res = await fetch(`https://api.lurkapi.com/v1/linkedin/company?${params}`, {
  headers: { "x-api-key": process.env.LURKAPI_API_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.specialties);

Node 18+. Save it as lurk.mjs and run node lurk.mjs. It reads your key from LURKAPI_API_KEY.

import os
import requests

res = requests.get(
    "https://api.lurkapi.com/v1/linkedin/company",
    params={
        "url": "https://www.linkedin.com/company/hubspot/",
    },
    headers={"x-api-key": os.environ["LURKAPI_API_KEY"]},
    timeout=60,
)
data = res.json()
if not data["success"]:
    raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["specialties"])

Run pip install requests, save it as lurk.py and run python lurk.py. It reads your key from LURKAPI_API_KEY.

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
	"os"
	"time"
)

func main() {
	params := url.Values{}
	params.Set("url", "https://www.linkedin.com/company/hubspot/")
	req, _ := http.NewRequest("GET", "https://api.lurkapi.com/v1/linkedin/company?"+params.Encode(), nil)
	req.Header.Set("x-api-key", os.Getenv("LURKAPI_API_KEY"))

	client := &http.Client{Timeout: 60 * time.Second}
	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	var data map[string]any
	if err := json.NewDecoder(res.Body).Decode(&data); err != nil {
		panic(err)
	}
	if data["success"] != true {
		panic(fmt.Sprintf("%v: %v", data["code"], data["error"]))
	}
	fmt.Println(data["specialties"])
}

Save it as main.go and run go run main.go. It reads your key from LURKAPI_API_KEY.

<?php
$params = http_build_query([
    'url' => 'https://www.linkedin.com/company/hubspot/',
]);
$context = stream_context_create(['http' => [
    'header' => 'x-api-key: ' . getenv('LURKAPI_API_KEY'),
    'timeout' => 60,
    'ignore_errors' => true,
]]);
$body = file_get_contents('https://api.lurkapi.com/v1/linkedin/company?' . $params, false, $context);
$data = json_decode($body, true);
if (!$data['success']) {
    throw new Exception("{$data['code']}: {$data['error']}");
}
print_r($data['specialties']);

Save it as lurk.php and run php lurk.php. It reads your key from LURKAPI_API_KEY.

require 'json'
require 'net/http'

uri = URI('https://api.lurkapi.com/v1/linkedin/company')
uri.query = URI.encode_www_form(
  'url' => 'https://www.linkedin.com/company/hubspot/',
)
req = Net::HTTP::Get.new(uri)
req['x-api-key'] = ENV.fetch('LURKAPI_API_KEY')
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https', read_timeout: 60) do |http|
  http.request(req)
end
data = JSON.parse(res.body)
raise "#{data['code']}: #{data['error']}" unless data['success']
puts data['specialties']

Save it as lurk.rb and run ruby lurk.rb. It reads your key from LURKAPI_API_KEY.

Parameters

Add them to the URL after a ?. Join several with &.

Parameter	Description
`url` stringrequired	A LinkedIn company page URL, e.g. https://www.linkedin.com/company/hubspot/. Use the main page, not a subpage like /jobs/ or /about/. Example `https://www.linkedin.com/company/hubspot/`

Example response

A real response, captured from the live API. Lists are trimmed to a couple of items, and long text such as media links is cut short with ….

Show the example response (3 KB)

{
  "success": true,
  "credits_remaining": 999977,
  "credits_charged": 1,
  "id": "68529",
  "url": "https://www.linkedin.com/company/hubspot",
  "name": "HubSpot",
  "tagline": "The agentic customer platform to scale your business.",
  "description": "HubSpot is a leading agentic customer platform that provides software an…",
  "website": "https://hubspot.com",
  "logo": "https://media.licdn.com/dms/image/v2/C4D0BAQF8H-SLmMDZlA/company-logo_20…",
  "industry": "Software Development",
  "size": "5,001-10,000 employees",
  "employeeCount": 12967,
  "followers": 1759995,
  "founded": 2006,
  "headquarters": "Cambridge, Massachusetts",
  "type": "Public Company",
  "specialties": [
    "inbound marketing",
    "marketing",
    "internet marketing",
    "online marketing",
    "web marketing",
    "software",
    "blogging",
    "SEO",
    "marketing automation",
    "social media",
    "email marketing",
    "analytics",
    "sales",
    "inbound sales",
    "customer support",
    "customer service",
    "customer relationship management",
    "help desk software",
    "platform",
    "customer code",
    "culture code"
  ],
  "posts": [
    {
      "id": "7511811320833347585",
      "url": "https://www.linkedin.com/posts/hubspot_our-customers-dont-need-more-tool…",
      "text": "Our customers don't need more tools. They need the tools they have to do…",
      "datePublished": "2026-10-02T15:36:21.590Z",
      "dateSource": "published",
      "likeCount": 56,
      "commentCount": 5,
      "images": [],
      "video": "https://dms.licdn.com/playlist/vid/v2/D4E10AQGQ_Z1y8mxlAw/mp4-360p-30fp-…",
      "document": null,
      "reposted": false,
      "resharedPost": null
    },
    {
      "id": "7511424909198258177",
      "url": "https://www.linkedin.com/posts/hubspot_the-marketing-team-the-second-the…",
      "text": "the marketing team the second the calendar says October",
      "datePublished": "2026-10-01T14:00:53.878Z",
      "dateSource": "published",
      "likeCount": 3681,
      "commentCount": 142,
      "images": [
        "https://media.licdn.com/dms/image/v2/D4E10AQE7kMbq5AXkDg/image-shrink_80…"
      ],
      "video": null,
      "document": null,
      "reposted": false,
      "resharedPost": null
    }
  ]
}

Response fields

Every field in a successful response, and what it means. A name with [] belongs to each item of a list: posts[].id is the id of every item in posts. null means there's no value.

Show all 47 fields

Field	Type	Description
success	true	Always true here; errors have `success: false`.
credits_remaining	number	Your balance after this call. On anonymous playground calls: free tries left today.
credits_charged	number	Credits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1).
id	stringcan be null	LinkedIn organization id, when exposed on the public page.
url	string	Canonical public LinkedIn company page URL.
name	string	Company name.
tagline	stringcan be null	Company's short tagline.
description	stringcan be null	Public About us text.
website	stringcan be null	External website published by the company.
logo	stringcan be null	Company logo URL; may expire.
industry	stringcan be null	Industry category shown by LinkedIn.
size	stringcan be null	Company headcount range as LinkedIn displays it, e.g. 5,001-10,000 employees.
employeeCount	numbercan be null	LinkedIn members associated with the company. It can differ from the size range the company states (`size`).
followers	numbercan be null	Followers of the company page, when published.
founded	numbercan be null	Founding year published by the company.
headquarters	stringcan be null	Headquarters location as displayed by LinkedIn.
type	stringcan be null	Organization type, e.g. Public Company.
specialties	string[]	Company specialties listed on the public page.
posts	object[]	The latest updates, reposts included, in LinkedIn's order. Usually up to 12, not the full history.
posts[].id	string	Activity id of this update, kept as a string to preserve all digits.
posts[].url	string	Public post URL or activity permalink.
posts[].text	string	The update's public text. Empty when the card only contains media.
posts[].datePublished	stringcan be null	When it was posted, in UTC. `dateSource` says where the time comes from.
posts[].dateSource	stringcan be null	`published`: LinkedIn states the time. `activity_id`: we read it from the update's id, which gives the post time for originals and the repost time for reposts. Null when unavailable.
posts[].likeCount	numbercan be null	Total reactions LinkedIn shows, not only likes; null when hidden.
posts[].commentCount	numbercan be null	Number of comments LinkedIn shows; null when hidden.
posts[].images	string[]	Images in the update, in order; the links expire. Empty for video-only or document-only updates (document pages are in `document`).
posts[].video	stringcan be null	A publicly playable video URL from the card, or null. URLs may expire.
posts[].document	objectcan be null	An attached document (PDF or slides), or null.
posts[].document.title	stringcan be null	Document title.
posts[].document.pageCount	numbercan be null	Number of pages LinkedIn reports for the document.
posts[].document.pageImages	string[]	Preview images of the first pages, in order. LinkedIn previews a few pages, not all. URLs may expire.
posts[].reposted	boolean	True when LinkedIn explicitly marks this update as a repost.
posts[].resharedPost	objectcan be null	The original post, when this update reposts it with commentary and embeds it; null otherwise. A plain repost has `reposted: true` and shows the original as the update itself.
posts[].resharedPost.id	string	Activity id of the original post.
posts[].resharedPost.url	string	Activity permalink of the original post.
posts[].resharedPost.author	object	Who published the original post.
posts[].resharedPost.author.name	stringcan be null	Author name.
posts[].resharedPost.author.url	stringcan be null	Author's LinkedIn profile or page URL.
posts[].resharedPost.text	string	The original post's text. Empty when it only contains media.
posts[].resharedPost.datePublished	stringcan be null	Publication time in UTC, decoded from the original's activity id.
posts[].resharedPost.images	string[]	Images in the original post, in source order. URLs may expire.
posts[].resharedPost.video	stringcan be null	A publicly playable video URL from the original post, or null. URLs may expire.
posts[].resharedPost.document	objectcan be null	An attached document (PDF or slides), or null.
posts[].resharedPost.document.title	stringcan be null	Document title.
posts[].resharedPost.document.pageCount	numbercan be null	Number of pages LinkedIn reports for the document.
posts[].resharedPost.document.pageImages	string[]	Preview images of the first pages, in order. LinkedIn previews a few pages, not all. URLs may expire.

Cost and freshness

Each call costs 1 credit. Calls turned away before they reach the platform (invalid parameters, a key or balance problem, a rate limit) are free, and so are 5xx errors. A not_found is charged, since the platform was checked. How charging works.

Answers are cached for up to 1 hour. A repeat call within that time can return the same data, and costs the same.

Errors

A failed call returns success: false, an error message, a code your program can check, and a docs link. These are the errors this endpoint can return. All error codes.

Status	Code	Meaning
401	`missing_api_key`	No API key was sent. Put it in the `x-api-key` header.
401	`invalid_api_key`	This key doesn't exist or was revoked.
402	`insufficient_credits`	Not enough credits for this call. Buy a pack, or wait for tomorrow's free top-up.
402	`over_max_credits`	This call would cost more than the `max_credits` you set. The error says what it needs; raise `max_credits` to allow it. Not charged.
403	`account_suspended`	This account is suspended. Email support@lurkapi.com. Not charged.
404	`not_found`	What you asked for (a post, an ad, a subreddit) doesn't exist, or there's no endpoint at that path. Charged if the platform was checked.
405	`method_not_allowed`	Endpoints only take `GET`, with parameters in the URL.
429	`rate_limited`	Too many calls in a short time. Wait as many seconds as the `retry-after` header says, then retry.
500	`internal_error`	Something broke on our side. Retry. Not charged.
502	`upstream_error`	The platform didn't send a usable answer. Retry. Not charged.
503	`upstream_busy`	All our connections to the platform are busy. Retry in a few seconds. Not charged.
504	`upstream_timeout`	The platform took over 30 seconds to answer (90 for web pages). Retry. Not charged.

Use it in Claude

Connect LurkAPI to Claude and ask in plain English. This endpoint is the linkedin_company tool. For example:

Ask Claude

Use LurkAPI's linkedin_company tool with url "https://www.linkedin.com/company/hubspot/", then summarize what you find.

Claude calls linkedin_company with arguments like these, and each call costs 1 credit:

Tool arguments

{"url": "https://www.linkedin.com/company/hubspot/"}

To save tokens, tool results leave out empty fields, keep one URL per image or video, and give transcripts as plain text unless you pass timestamps=true. A result over 45,000 characters comes in parts. Its _note gives the offset for the next part, and later parts are free for 15 minutes. Pass trim=false for the full response.

From the blog

All posts