GET

/api/v1/profile/username-to-urn

10 credits

Resolve a public handle to its stable prsn_ profile id (the dataset id used by /profile/* lookups). For the live person endpoints — posts, comments, interests — use /api/v1/profile/entity-id instead; the two ids are not interchangeable. The response is the full profile record — read data.id; no second call needed.

Try in Playground

Parameters

Name	Type	Required	Description
handle	string	yes	Public profile handle to resolve — the part after linkedin.com/in/. (e.g. `satyanadella`)

Example request

curl -H "X-API-Key: zq_…" \
  "https://zooq.dev/api/v1/profile/username-to-urn?handle=satyanadella"

Example response

// trimmed — the actual response is the FULL profile record (all fields); read data.id
{
  "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"
  }
}

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

Want to try this endpoint?

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

Get an API key →