Skip to content
Now out of stealth: the missing link between AI agents and LinkedIn data.
← Profile
GET

/api/v1/profile/full

10 credits

Complete profile in one call — positions, education, skills, certifications, geo, follower/connection counts and flags. This is the canonical profile read; the other profile/* paths (overview, details, about, education, skills, certifications, full-experience, social-matrix) are named aliases that return this exact same record.

Try in Playground

Parameters

NameTypeRequiredDescription
handlestringnoPublic profile handle. Provide handle OR id. (e.g. satyanadella)
idstringnoStable profile id (prsn_...). Get it from /api/v1/profile/full or /search/people — read data.id. Provide handle OR id. (e.g. prsn_pgvv42ri57uei)

Example request

curl -H "X-API-Key: zq_…" \
  "https://zooq.dev/api/v1/profile/full?handle=satyanadella&id=prsn_pgvv42ri57uei"

Example response

{
  "success": true,
  "statusCode": 200,
  "message": "Profile retrieved successfully",
  "errors": null,
  "data": {
    "id": "prsn_pgvv42ri57uei",
    "url": "https://linkedin.com/in/satyanadella",
    "handle": "satyanadella",
    "first_name": "Satya",
    "last_name": "Nadella",
    "is_creator": true,
    "is_premium": true,
    "is_influencer": true,
    "follower_count": 12086488,
    "connections_count": 831,
    "headline": "Chairman and CEO at Microsoft",
    "summary": "As chairman and CEO of Microsoft, I define my mission...",
    "geo": { "city": "Redmond, Washington", "full": "Redmond, Washington, United States", "country": "United States", "countryCode": "us" },
    "full_positions": [
      { "is_current": true, "title": "Chairman and CEO", "organization_name": "Microsoft", "organization_id": "org_jb3e59e3q21b8", "organization_url": "https://www.linkedin.com/company/microsoft/", "organization_slug": "microsoft", "organization_industry": "Computer Software", "organization_headcount_range": "10,001+ employees", "start": { "year": 2014, "month": 2 }, "end": null }
    ],
    "education": [
      { "institution_id": "inst_a8tl7ot52lsge", "school_name": "Manipal Institute of Technology, Manipal", "degree": "Bachelor's Degree", "field_of_study": "Electrical Engineering" }
    ]
  }
}

Successful responses are wrapped in the standard envelope. The data field carries the actual payload; errors is null on success.

Available via MCP as profile_full

Add Zooq as an MCP server to Claude Desktop or Cursor and call this tool directly from your agent. See the MCP guide.

Want to try this endpoint?

300 free credits on signup, no card required. That covers 30 calls.

Get an API key →