API reference

LinkFetch exposes a small, stable REST surface. Every endpoint is also available as a typed method on the TypeScript and Python SDKs, and as a tool in our MCP server.

Endpoints

GET /v1/profiles

Profile lookup by URL or email.

GET /v1/companies/:slug

Structured company record.

GET /v1/jobs

Fresh job postings, filterable.

GET /v1/posts

Public posts and engagement.

Profiles

GET https://api.linkfetch.io/v1/profiles?url=linkedin.com/in/ada
Authorization: Bearer sk_live_...

{
  "profile": {
    "url": "https://linkedin.com/in/ada",
    "name": "Ada Lovelace",
    "headline": "Mathematician",
    "location": "London, UK",
    "experience": [
      { "company": "Analytical Engine", "title": "Research Lead", "from": "1843-06" }
    ],
    "education": [],
    "skills": ["mathematics", "cryptography"]
  },
  "provenance": {
    "source": "cache+coresignal",
    "fetched_at": "2026-04-20T14:02:11Z",
    "freshness_days": 6
  }
}

Companies

GET /v1/companies/stripe

Ships the canonical company record: size, industry, HQ, funding signals, and an employee-count trend when we have it.

Jobs

GET /v1/jobs?company=stripe&seniority=senior&posted_within=7d

Filterable by company, keyword, location, seniority, and freshness window.

Posts

GET /v1/posts?author=linkedin.com/in/ada&limit=20

Public post content plus engagement counts — likes, comments, reposts.