LinkedIn tools

Public LinkedIn data. Each call costs what the data provider charges for it, and the cost line under each tool below gives the number. A question LinkedIn cannot answer has no tool, rather than a tool that returns nothing.

#Get a LinkedIn profile

linkedin_get_profile

One LinkedIn person: their headline, location, followers and connections.

Use when: checking a person before outreach, reading how they describe themselves.

Not for: a company page, use linkedin_get_company. An email address, use leads_get_email. A person's full employment record, use leads_get_person.

Returns: Record. platform, kind, id, handle, name, url, bio, verified, followers, following, posts_count, likes, views, location, website, employees, industry, created_at. A field the platform does not publish is null. LinkedIn publishes no post count or id for a person, so those are null.

Cost: 1 credit. Cached 24 hours.

Also takes provider, max_credits, dry_run: see common parameters.

{
  "url": "https://www.linkedin.com/in/williamhgates"
}

#Get a company page

linkedin_get_company

One LinkedIn company page: headcount, industry, location and website.

Use when: sizing a company from its own page, confirming an industry and a headcount band before outreach.

Not for: a company's own posts, use linkedin_get_company_posts. A richer firmographic record, use leads_get_company. A person, use linkedin_get_profile.

Returns: Record. platform, kind, id, handle, name, url, bio, verified, followers, following, posts_count, likes, views, location, website, employees, industry, created_at. A field the platform does not publish is null. kind is company, employees is LinkedIn's own headcount.

Cost: 1 credit. Cached 24 hours.

Also takes provider, max_credits, dry_run: see common parameters.

{
  "handle": "shopify"
}

#Get a company's posts

linkedin_get_company_posts

The posts on one LinkedIn company page, newest first.

Use when: watching what a competitor publishes, judging cadence and engagement.

Not for: posts by topic across LinkedIn, use linkedin_search_posts. One post in full, use linkedin_get_post.

Returns: List, one page per call. rows[]: platform, id, url, author, author_name, created_at, text (cut at 2000 characters), likes, comments, shares, views, media, duration_s, is_ad. A number the platform does not publish is null. LinkedIn publishes no view count, so views is null. This listing carries no engagement at all; linkedin_get_post has likes and comments for one post. created_at is approximate: the platform shows an age such as "3 weeks ago", so it is exact only to that unit.

Cost: 1 credit per page. Cached 6 hours.

Also takes cursor, provider, max_credits, dry_run: see common parameters.

{
  "handle": "shopify"
}

#Get a LinkedIn post

linkedin_get_post

One LinkedIn post with its text, its author and its engagement.

Use when: a row from a search is worth the detail, or you have a URL and nothing else.

Not for: the comments (LinkedIn does not expose them here). A company's whole feed, use linkedin_get_company_posts.

Returns: Record. rows[]: platform, id, url, author, author_name, created_at, text (cut at 2000 characters), likes, comments, shares, views, media, duration_s, is_ad. A number the platform does not publish is null.

Cost: 1 credit. Cached 6 hours.

Also takes provider, max_credits, dry_run: see common parameters.

{
  "url": "https://www.linkedin.com/posts/aagupta_what-you-need-to-know-ai-agents-activity-7354600338621906944-RvXR"
}

#Search LinkedIn posts

linkedin_search_posts

LinkedIn posts matching a keyword, ranked by LinkedIn's own search.

Use when: "what is being said about X on LinkedIn", finding the people posting about a category.

Not for: one company's posts, use linkedin_get_company_posts. Finding people to contact, use leads_search_people.

Returns: List, one page per call, ranked. rows[]: platform, id, url, author, author_name, created_at, text (cut at 2000 characters), likes, comments, shares, views, media, duration_s, is_ad. A number the platform does not publish is null. meta.cursor pages the next set. created_at is approximate: the platform shows an age such as "3 weeks ago", so it is exact only to that unit.

Cost: 1 credit per page. Cached 6 hours.

Also takes cursor, provider, max_credits, dry_run: see common parameters.

{
  "query": "rfp automation",
  "since": "week"
}