curl -X POST https://api.up2data.ai/v1/profiles/recommendations \
-H "X-API-Key: $UP2DATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://linkedin.com/in/janedoe", "direction": "both", "page": 1}'
import requests
resp = requests.post(
"https://api.up2data.ai/v1/profiles/recommendations",
headers={"X-API-Key": UP2DATA_API_KEY},
json={"url": "https://linkedin.com/in/janedoe", "direction": "given"},
)
data = resp.json()["data"]
{
"data": {
"url": "https://linkedin.com/in/janedoe",
"urn": "ACoAA…",
"direction": "both",
"given": {
"recommendations": [{
"text": "Jane is an exceptional leader…",
"relationship": "Managed Jane directly",
"created_at": "2024-03-15T00:00:00Z",
"person": {
"url": "https://linkedin.com/in/example",
"full_name": "Alex Example",
"headline": "VP Sales",
"urn": "ACoAA…"
}
}],
"pagination": { "page": 1, "per_page": 10, "has_more": false }
},
"received": {
"recommendations": [{
"text": "Outstanding engineer…",
"relationship": "Worked with Jane on the same team",
"created_at": "2025-01-10T00:00:00Z",
"person": {
"url": "https://linkedin.com/in/manager",
"full_name": "Sam Manager",
"headline": "Engineering Director",
"urn": "ACoAA…"
}
}],
"pagination": { "page": 1, "per_page": 10, "has_more": true }
},
"scraped_at": "2026-07-08T12:00:00Z"
},
"meta": {
"creditsUsed": 2,
"creditsRemaining": 98418,
"billed": true,
"reason": "success",
"requestId": "req_example",
"latencyMs": 2100
}
}
Profiles
Get profile recommendations
Recommendations given and/or received via a direction parameter — not separate endpoints.
POST
/
v1
/
profiles
/
recommendations
curl -X POST https://api.up2data.ai/v1/profiles/recommendations \
-H "X-API-Key: $UP2DATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://linkedin.com/in/janedoe", "direction": "both", "page": 1}'
import requests
resp = requests.post(
"https://api.up2data.ai/v1/profiles/recommendations",
headers={"X-API-Key": UP2DATA_API_KEY},
json={"url": "https://linkedin.com/in/janedoe", "direction": "given"},
)
data = resp.json()["data"]
{
"data": {
"url": "https://linkedin.com/in/janedoe",
"urn": "ACoAA…",
"direction": "both",
"given": {
"recommendations": [{
"text": "Jane is an exceptional leader…",
"relationship": "Managed Jane directly",
"created_at": "2024-03-15T00:00:00Z",
"person": {
"url": "https://linkedin.com/in/example",
"full_name": "Alex Example",
"headline": "VP Sales",
"urn": "ACoAA…"
}
}],
"pagination": { "page": 1, "per_page": 10, "has_more": false }
},
"received": {
"recommendations": [{
"text": "Outstanding engineer…",
"relationship": "Worked with Jane on the same team",
"created_at": "2025-01-10T00:00:00Z",
"person": {
"url": "https://linkedin.com/in/manager",
"full_name": "Sam Manager",
"headline": "Engineering Director",
"urn": "ACoAA…"
}
}],
"pagination": { "page": 1, "per_page": 10, "has_more": true }
},
"scraped_at": "2026-07-08T12:00:00Z"
},
"meta": {
"creditsUsed": 2,
"creditsRemaining": 98418,
"billed": true,
"reason": "success",
"requestId": "req_example",
"latencyMs": 2100
}
}
Cost: 1 credit per direction scraped ·
Each recommendation:
Rate limit: counts as 1 request against your rate limit.
direction: both = 2 credits · pay only on success
One endpoint with a direction parameter — not separate /given and /received routes. Each direction is its own scrape; pass direction: both to fetch both lists in one HTTP call (billed as two scrapes).
string
Profile URL or public identifier (e.g.
satyanadella). Provide url or urn.string
LinkedIn member URN (e.g.
ACoAAB…). Preferred when you already have it from search or engagement endpoints.string
default:"both"
given | received | both — which recommendation lists to scrape. given and received are separate scrapes.integer
default:"1"
integer
default:"10"
1–25 per list.
Response
string
Echo of the requested scrape scope.
object
Present when
direction is given or both. recommendations[] plus pagination.object
Present when
direction is received or both. Same shape as given.text, relationship, created_at, person (url, full_name, headline, urn).
curl -X POST https://api.up2data.ai/v1/profiles/recommendations \
-H "X-API-Key: $UP2DATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://linkedin.com/in/janedoe", "direction": "both", "page": 1}'
import requests
resp = requests.post(
"https://api.up2data.ai/v1/profiles/recommendations",
headers={"X-API-Key": UP2DATA_API_KEY},
json={"url": "https://linkedin.com/in/janedoe", "direction": "given"},
)
data = resp.json()["data"]
{
"data": {
"url": "https://linkedin.com/in/janedoe",
"urn": "ACoAA…",
"direction": "both",
"given": {
"recommendations": [{
"text": "Jane is an exceptional leader…",
"relationship": "Managed Jane directly",
"created_at": "2024-03-15T00:00:00Z",
"person": {
"url": "https://linkedin.com/in/example",
"full_name": "Alex Example",
"headline": "VP Sales",
"urn": "ACoAA…"
}
}],
"pagination": { "page": 1, "per_page": 10, "has_more": false }
},
"received": {
"recommendations": [{
"text": "Outstanding engineer…",
"relationship": "Worked with Jane on the same team",
"created_at": "2025-01-10T00:00:00Z",
"person": {
"url": "https://linkedin.com/in/manager",
"full_name": "Sam Manager",
"headline": "Engineering Director",
"urn": "ACoAA…"
}
}],
"pagination": { "page": 1, "per_page": 10, "has_more": true }
},
"scraped_at": "2026-07-08T12:00:00Z"
},
"meta": {
"creditsUsed": 2,
"creditsRemaining": 98418,
"billed": true,
"reason": "success",
"requestId": "req_example",
"latencyMs": 2100
}
}