GET

/api/v1/profile/similar

10 credits

Similar professional profiles — expand a shortlist from one example.

Parameters

Name	Type	Required	Description
handle	string	no	Public profile handle — the part after linkedin.com/in/ — or the full profile URL. Resolved to `entityId` automatically at no extra credit cost. Any person identifier is accepted here and sorted by format (handle, URL, ACoAA… entityId, prsn_ id). Provide `entityId` OR `handle`; `handle` is the simplest. (e.g. `satyanadella`)
entityId	string	no	Live person entityId (ACoAA…) from profile_entity_id / profile_enrich; the urn:li:fsd_profile: form is accepted. A prsn_ id (dataset namespace, from profile_full) or a handle placed here is recognized and translated automatically. Provide `entityId` OR `handle`.

Example request

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

Example response

// documented shape - Live API; live-unverified (outage)
{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "errors": null,
  "data": {
    "profiles": [
      { "entityId": "prsn_...", "handle": "jane-doe", "fullName": "Jane Doe", "headline": "VP Engineering", "location": { "city": "Seattle", "country": "United States" } }
    ],
    "total": 20
  }
}

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 →