LinkedIn enrichment

Company data from LinkedIn, one call.

Give a LinkedIn company page and get its headcount, industry, headquarters, website and latest posts as JSON, next to the French registry data you already get from /entreprise.

Five endpoints

Company firmographics

2 credits per call
POST /linkedin-company

Headcount and headcount bracket, industry, headquarters and offices, website and domain, founding year, description, specialities and company type, from the company's public LinkedIn page.

Company posts

2 credits per page
POST /linkedin-company/posts

One page of the company page's posts (up to 50), newest first: text, date, type, reactions, comments and shares. Hiring drives, new sites, fundraising and appointments are visible here first.

Member posts

2 credits per page
POST /linkedin-posts

One page of a decision maker's own posts (up to 50): text, date, engagement.

Post engagement

2 credits per page
POST /linkedin-post/engagement

Who commented on and reacted to a post: name, headline and profile URL, one page of comments and one page of reactions per call.

Member activity

2 credits per page
POST /linkedin-profile/activity

The posts a member recently reacted to or commented on, with each post.

How it is billed

Example

Request

curl -X POST https://tools.epsimo.org/linkedin-company \
  -H "x-token: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"https://www.linkedin.com/company/doctolib"}'

Response (trimmed)

{
  "company": {
    "name": "Doctolib",
    "linkedin_url": "https://www.linkedin.com/company/doctolib/",
    "website": "https://www.doctolib.fr/",
    "domain": "doctolib.fr",
    "industry": "Software Development",
    "employee_count": 3714,
    "employee_range": {"min": 1001, "max": 5000},
    "founded_year": 2013,
    "headquarters": {"city": "Levallois-Perret", "country": "FR", "...": "..."},
    "...": "..."
  },
  "source": [{"name": "LinkedIn public company pages, via Fetchin", "...": "..."}],
  "status": 200,
  "error_message": null
}

Questions

What can I pass as the company?

A LinkedIn company page URL (linkedin.com/company/<slug>, school and showcase pages too), the slug alone, or a company URN.

Do you return people?

The member routes return personal data: name, headline and profile URL only (no photo, contact details or location). Use them only with a lawful basis, typically legitimate interest for B2B prospecting, and honour objections. Anyone can remove themselves with POST /privacy/opt-out and their LinkedIn URL: they are then absent from every response. Sentences, comments and people revealing a union role are removed, and an activity item on such a post is dropped whole.

Where does the data come from?

Public LinkedIn company pages, fetched in real time through our data provider Fetchin. Each response names its source.

What if the provider is unavailable?

The call returns 503 with a Retry-After header and is not billed.

Can my AI agent use it?

Yes: the MCP server exposes enrich_company_linkedin and get_company_linkedin_posts, get_linkedin_member_posts, get_linkedin_post_engagement and get_linkedin_member_activity, all documented in llms-full.txt.