Linkfetch
get key ↗
sheet 01 / 08—linkfetch / linkedin api
the linkedin api for ai agents

One call,
the whole
LinkedIngraph.

Profiles, companies, and jobs returned as typed JSON. Native to Claude, Cursor, and anything that speaks MCP — with your session, your consent, and provenance on every row.

get api key — $5 freeread the docs
t₀ → call
90s
p50
184ms
fake accts
0

no card ● empty results never charged ● public data only ● gdpr + ccpa aligned

instrumentlinkfetch.scanlive
url
https://
complete·parse·enrich·verify
100%
response200184ms
GET /v1/profiles
{  "profile": {    "name": "Ada Lovelace",    "headline": "Mathematician · First programmer",    "location": "London, UK",    "current": { "company": "Analytical Engine", "title": "Research Lead" },    "skills": ["numerical analysis", "symbolic logic", "mechanical computing"]  },  "provenance": {    "source": "extension",    "fetched_at": "2026-04-23T14:02:11Z",    "freshness_days": 6  }}
credits5of 5 budget
freshness6dfetched just now
sourceextensionprovenance ok
ll-0042 · scan-profileschema v1 ●
speaks natively toclaude desktopcursorcontinue.devzedwindsurfaidervscode+mcp
§ catalog · 8 surfaces

31 endpoints, one envelope.

Profiles, companies, jobs, posts, groups, search, locations, and outbound — every response carries a provenance stamp and a predictable credit cost. Jump to a surface, or scroll the full list. Empty result sets are never charged.

§ profiles·3 endpoints

Profiles — The person, the whole résumé.

Resolve a public LinkedIn profile URL or vanity slug to a typed person record — name, headline, roles, education, skills, certifications, and recent activity. Cache-first: if the row isn't stored yet, a 422 tells the LinkFetch Chrome extension to capture it from the user's own signed-in session. No fake accounts, no rented sessions.

§ companies·4 endpoints

Companies — Size, funding, headcount trend.

Resolve a company slug or numeric ID to a structured company record — industry, headcount band, locations, follower count. Pair with the employees endpoint for ICP company-list expansion.

§ jobs·3 endpoints

Jobs — Our scraped LinkedIn jobs dataset.

Filter our self-hosted LinkedIn jobs dataset by keyword, geo, company, salary, level, and date. Every record carries a posted_at timestamp and a first-seen window so you can build hiring signals — not just a job board mirror. No extension needed; just an API key.

§ posts·2 endpoints

Posts — Single posts with reactions and counts.

Fetch a specific LinkedIn post by activity ID — body, author, ugcPost URN, reaction breakdown by type, and view counts where LinkedIn exposes them. Then enumerate the reactors for warm-list building or distribution analytics.

§ outbound·12 endpoints

Outbound — Act on the graph, with consent.

Send connection requests, messages, reactions, comments, follows, and saves through the user's own LinkedIn session. Every action runs in the LinkFetch Chrome extension on a signed-in tab — throttled, queued, and logged. Strangers' DMs are explicitly blocked: the extension verifies a 1st-degree connection before sending.

§ response envelope

Every endpoint returns the same shape.

A predictable envelope means your error handling, retry logic, and observability code can be written once and reused across every surface.

application/json200 OK
{
  "data": { /* the typed record(s) for this surface */ },
  "meta": {
    "request_id": "req_01HZ...",
    "credits_charged": 5,
    "rate_limit": { "remaining": 4995, "reset_at": "..." },
    "provenance": {
      "source": "extension",
      "fetched_at": "2026-04-23T10:14:22Z",
      "freshness_days": 0
    }
  }
}

Errors use the same envelope with a top-level error object — code, message, and the same request_id you'd find in our logs. Empty result sets return data: [] and are never charged.

§ auth · limits · sla

Bearer keys, predictable limits.

Bearer auth

Every request carries Authorization: Bearer sk_live_… Keys scope by environment (test vs live) and rotate without downtime.

Rate limits

1,000 requests / minute per key by default; bursts to 2,000. Enterprise plans lift the ceiling. Limits are returned on every response.

Latency

p50 under 200ms for cached reads. First-fetch profile or company can take a few seconds while the user's session renders the page.

Idempotency

POST endpoints accept Idempotency-Key. Safe retries on transient network errors without side-effect duplication.

Webhooks

Subscribe to profile-changed, company-changed, and job-first-seen events to skip polling. Delivered with HMAC-signed payloads.

SLA

99.9% monthly availability on Pro and Scale. Status page at status.linkfetch.io. Incidents reported within 15 minutes.

Ship your first call in 90 seconds.

Sign up, copy a key, paste a curl. $5 of credit on the house — no card, no commitment, no fake-account risk on your domain.

get api key — $5 free ↗read the docs