Install the Up2Data skill

Teach Claude Code to integrate the Up2Data API. Installs once, then loads automatically whenever you ask it about Up2Data.

Run this in your terminal

bash

mkdir -p ~/.claude/skills/up2data-api && curl -fsSL https://up2data.ai/docs/v1/skill.md -o ~/.claude/skills/up2data-api/SKILL.md

Restart Claude CodeSo it picks up the new skill.
Try it"Enrich these LinkedIn profiles with Up2Data and send results to my webhook"

Requires Claude Code. macOS, Linux, or WSL.

Prefer to read it first? View the skill file

Get profile recommendations

Get the written recommendations a profile has received, given, or both.

POSThttps://api.up2data.ai/v1/profiles/recommendations

1 credit per non-empty directiondirection both is up to 2; empty results are freesynchronous

One endpoint with a direction parameter, not separate given and received routes. Identify the profile with url or urn; provide exactly one. Each requested direction comes back as its own block with its own pagination. A block with no recommendations has an empty list and no pagination.

Info

Send many as batch operation items (operation profiles.recommendations); billed per non-empty direction, same as the sync call. See the batch endpoint.

#Request

Field	Type	Notes
`url`	`string`	Profile URL or public identifier. Provide url or urn.
`urn`	`string`	LinkedIn member URN. Provide url or urn.
`direction`	`string`	Default both. Enum: given, received, both.
`page`	`integer`	Default 1. Applies to each direction.
`per_page`	`integer`	Default 10. 1 to 25, per direction.

#Call it

cURL

curl -X POST "https://api.up2data.ai/v1/profiles/recommendations" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.linkedin.com/in/janedoe",
  "direction": "both",
  "page": 1
}'

Python

import requests

url = "https://api.up2data.ai/v1/profiles/recommendations"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "url": "https://www.linkedin.com/in/janedoe",
    "direction": "both",
    "page": 1
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Node

const url = "https://api.up2data.ai/v1/profiles/recommendations";
const headers = {
  "X-API-Key": "YOUR_API_KEY",
  "Content-Type": "application/json",
};
const body = {
  "url": "https://www.linkedin.com/in/janedoe",
  "direction": "both",
  "page": 1
};

const response = await fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(body),
});
const data = await response.json();
console.log(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://api.up2data.ai/v1/profiles/recommendations"
	body := bytes.NewBufferString(`{
  "url": "https://www.linkedin.com/in/janedoe",
  "direction": "both",
  "page": 1
}`)
	req, err := http.NewRequest("POST", url, body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	respBody, _ := io.ReadAll(resp.Body)
	fmt.Println(string(respBody))
}

#Response

200 - direction: both

{
  "data": {
    "url": "https://www.linkedin.com/in/janedoe", "public_identifier": "janedoe", "linkedin_id": "123456789", "urn": "ACoAABOPHB8BM6example", "direction": "both", "scraped_at": "2026-07-08T12:00:00Z",
    "given": {
      "recommendations": [{ "text": "Jane is an exceptional leader. She rebuilt our go-to-market motion around live profile data.", "relationship": "Jane managed Alex directly", "created_at": "2024-03-15T00:00:00Z", "person": { "url": "https://www.linkedin.com/in/example", "full_name": "Alex Example", "headline": "VP Sales at Example Corp", "urn": "ACoAABOPHB8BM6alexex" } }],
      "pagination": { "page": 1, "per_page": 10, "has_more": false }
    },
    "received": {
      "recommendations": [{ "text": "Outstanding engineer and a generous mentor.", "relationship": "Sam worked with Jane on the same team", "created_at": "2025-01-10T00:00:00Z", "person": { "url": "https://www.linkedin.com/in/manager", "full_name": "Sam Manager", "headline": "Engineering Director at Example Corp", "urn": "ACoAABOPHB8BM6sammgr" } }],
      "pagination": { "page": 1, "per_page": 10, "has_more": true }
    }
  },
  "meta": { "creditsUsed": 2, "creditsRemaining": 98418, "billed": true, "reason": "success", "requestId": "req_example", "latencyMs": 2100 }
}

200 - No recommendations

{
  "data": {
    "url": "https://www.linkedin.com/in/janedoe", "public_identifier": "janedoe", "linkedin_id": "123456789", "urn": "ACoAABOPHB8BM6example", "direction": "both", "scraped_at": "2026-07-08T12:00:00Z",
    "given": { "recommendations": [] },
    "received": { "recommendations": [] }
  },
  "meta": { "creditsUsed": 0, "creditsRemaining": 98420, "billed": false, "reason": "empty_result", "requestId": "req_example", "latencyMs": 1900 }
}

#Errors

Status	Type	When	Billed
400	`invalid_request`	Malformed body, unknown field, bad URL format, or a direction outside the enum.	No
401	`invalid_api_key`	Missing, malformed, or revoked key.	No
402	`insufficient_credits`	Balance can't cover every requested direction.	No
422	`unprocessable_target`	Profile not found, private, deleted, or unreachable. Billed as 1 credit.	Yes
429	`rate_limited`	Over the 300 requests/min per-key limit. Honor Retry-After.	No
500	`internal_error`	Something broke on the server side.	No
504	`upstream_timeout`	The live scrape didn't complete in time.	No

See the Errors guide for every error type this version can return.