Paid checkout is currently closed. Prices below are listed for reference; request an opening notification in your billing dashboard.

// Guide

Get a full LinkedIn profile via API

Looking for an API that returns someone's complete LinkedIn profile, not just a name and a photo? Here's why LinkedIn's own API won't give you that, what a full profile looks like as JSON, and code that fetches one from a profile URL.

Full historyEvery job and school, with dates.
SkillsWith endorsement counts.
Employer dataIndustry, size and website of current companies.
Pay per foundProfiles we can't find are free.

Why LinkedIn's own API doesn't return full profiles

The API most developers can use, Sign In with LinkedIn (OpenID Connect), returns only the signed-in member's own basic details: name, photo and email. Access to other members' profiles is limited to LinkedIn's approved partner programs. So to look up a profile from its URL, people either scrape it in their own session, which LinkedIn's User Agreement forbids and which puts that account at risk (see the scraper guide), or use a data API that doesn't involve their LinkedIn login.

What a full profile looks like

With EnrichGrid one profile includes name, headline and summary · current title, seniority and job function · current company with its website, headcount and industry · every past job with dates · education · skills with endorsements · location and country · followers and connections · certifications and recommendations. The shape of a response, values left out:

{
  "status": "done",
  "found": true,
  "credits_charged": 1,
  "kind": "person",
  "profile": {
    "first_name": "...", "last_name": "...", "headline": "...", "summary": "...",
    "current_title": "...", "current_company_name": "...", "seniority": "...", "job_function": "...",
    "location": "...", "location_country": "...", "follower_count": 0, "num_connections": 0,
    "current_companies": [{"company_name": "...", "titles": ["..."], "entreprise": {"industry": "...",
                           "staff_count": 0, "website_url": "...", "...": "..."}}],
    "sections": {
      "experiences": [{"title": "...", "company_name": "...", "company_id": 0, "location": "...",
                       "started_on": "2021-03-01", "ended_on": null, "is_current": true, "description": "..."}],
      "educations": [{"school_name": "...", "degree_name": "...", "field_of_study": "...",
                      "started_on": "...", "ended_on": "..."}],
      "skills": [{"name": "...", "endorsement_count": 0}]
    },
    "certifications": [], "honors": [], "volunteering": [], "...": "..."
  }
}

The work history is in sections.experiences, schools in sections.educations and skills in sections.skills. A real, unedited response is on the home page.

Fetch a full profile in Python

Set ENRICHGRID_KEY to the key from your dashboard and run:

import os, time, requests

API = "https://enrichgrid.com/v1"
H = {"x-api-key": os.environ["ENRICHGRID_KEY"]}

def full_profile(url, live=False):
    r = requests.post(f"{API}/enrich/person", headers=H, json={"identifier": url, "live": live}, timeout=120)
    r.raise_for_status()  # 401 bad key, 402 out of credits, 429 too fast (wait and retry)
    data = r.json()
    while data.get("status") == "pending":  # 202: still collecting; polling is free
        time.sleep(3)
        data = requests.get("https://enrichgrid.com" + data["poll"], headers=H, timeout=30).json()
    return data.get("profile") if data.get("found") else None  # not found = no charge

p = full_profile("https://www.linkedin.com/in/williamhgates")
sections = p.get("sections") or {}
print(p["first_name"], p["last_name"], "-", p.get("headline"))
for job in sections.get("experiences", []):
    print(f'  {job.get("started_on")} to {job.get("ended_on") or "present"}: {job.get("title")} at {job.get("company_name")}')
for school in sections.get("educations", []):
    print("  school:", school.get("school_name"), school.get("degree_name") or "")
print("  skills:", ", ".join(s["name"] for s in sections.get("skills", [])[:10]))

Most profiles come back in a few seconds. Slower ones answer 202 with a poll link, which the loop checks for free. A profile requested in the last 30 days comes from our cache; send live=True to collect it fresh at the same price. For many profiles at once, see the Python guide.

Other ways to call it

  • Any language: one POST /v1/enrich/person with a JSON body; examples in the API reference.
  • Google Sheets: =ENRICHGRID(A2) per row (guide).
  • A whole file: upload a CSV or Excel list to bulk enrichment.
  • AI agents: Claude, Cursor and other MCP clients can call it through the MCP server.

What it costs

One credit per found profile; profiles we can't find cost nothing. Eligible new accounts receive 50 initial credits after email verification, subject to one-grant-per-person checks. Listed monthly prices range from $29 for 10,000 credits ($2.90 per 1,000) to $999 for 1,000,000 ($1.00 per 1,000). See pricing.

// FAQ

Questions, answered

Is this the official LinkedIn API?

No. EnrichGrid is an independent data API that returns public professional profile data. You don't need a LinkedIn developer app or partner approval.

What can I send as input?

A profile URL (linkedin.com/in/...), the slug alone, or the profile ID.

Do you return emails or phone numbers?

No. EnrichGrid returns professional profile data: role, company, work history, education and skills.

How fresh is the data?

A profile copy fetched within the last 30 days may be reused. Send "live": true to request a live refresh. Older cached records may remain stored until refreshed or removed.

Can I find profiles instead of looking them up?

Yes. People search (POST /v1/search) finds people by current title, company, country and more, 10 per page.

Start enriching in the next 60 seconds

50 initial credits after email verification, subject to one-grant-per-person checks. No credit card. Pay only for what we find.

Create a free account →
Questions? Ask us 👋