InsightSocial API
LinkedIn

LinkedIn Profile Recommendations API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/linkedin/profile/recommendations?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fsatyanadella%2F" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/linkedin/profile/recommendations

Returns the recommendations on a LinkedIn member's profile, with the recommender's name and headline, the recommendation text, and date.

Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Schema 2.

Use it for written references, and set type to received or given to choose which side of the relationship you want.

50 credits per call.

Paginates by cursor: see Pagination.

x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

url*string

Full URL of the LinkedIn profile, company, or post.

page?integer

1-based page number. Defaults to 1.

Range1 <= value
type?string

Filter by kind. See the allowed values.

Value in

  • "received"
  • "given"
urn?string

The member's opaque LinkedIn URN, as returned in author.ext.urn by /v1/linkedin/profile. Optional, and a pure optimisation: pass it ALONGSIDE url (which stays required) and this call skips the internal handle lookup, so it answers faster. Verified on the deployed API 05/09/2026.

cursor?string

The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/linkedin/profile/recommendations?url=string"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "property1": null,    "property2": null  }}