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 PlaygroundParameters
| Name | Type | Required | Description |
|---|---|---|---|
| handle | string | no | Public profile handle. Provide handle OR id. (e.g. satyanadella) |
| id | string | no | Stable 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 →