/api/v1/profile/recommendations

10 credits

Recommendations written for the person, with author details and text.

Parameters

Name	Type	Required	Description
handle	string	no	Public profile handle — the part after linkedin.com/in/. Resolved to `entityId` automatically at no extra credit cost. Provide `entityId` OR `handle`. (e.g. `satyanadella`)
entityId	string	no	Person entityId from /api/v1/profile/entity-id or /api/v1/profile/enrich. NOT the prsn_ id from /profile/username-to-urn — that is the dataset namespace and the live endpoints reject it. Provide `entityId` OR `handle`.

Example request

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

Example response

// documented shape - Live API; live-unverified (outage)
{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "errors": null,
  "data": {
    "endorsements": [
      {
        "author": { "entityId": "prsn_...", "handle": "jane-doe", "fullName": "Jane Doe", "headline": "VP Engineering at Contoso" },
        "relationship": "Managed Jane directly",
        "text": "One of the most thoughtful engineering leaders I have worked with...",
        "createdAt": "2024-11-02T00:00:00Z"
      }
    ]
  }
}

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 →