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

Search people

Live people search with structured filters.

POSThttps://api.up2data.ai/v1/search/people

1 credit per page (up to 25 results)synchronous

Pass structured filters; at least one is required. Geo, industry, company, and school filters take LinkedIn IDs, not free text. Runs the same search as Search people (Sales Navigator) and returns the same results; use that endpoint to paste a Sales Navigator URL instead. meta.resolved_search_url is the equivalent LinkedIn search URL. Empty pages are free. A single call returns at most 100 results (pagination.has_more is true when more exist).

Info

Counts as 1 request against the 300/min per-key limit and 1 search against the 20/hour per-organization search quota. See Rate limits.

Info

Send many as batch operation items (operation search.people.sales_nav, with body.filters); up to 2,500 results per item. See the batch endpoint.

#Request

Field	Type	Notes
`filters`required	`object`	Structured filter object; at least one field.
`filters.keywords`	`string`
`filters.titles`	`string[]`
`filters.past_titles`	`string[]`
`filters.seniorities`	`string[]`	Enum per item: owner, partner, cxo, vp, director, manager, senior, entry, training, strategic.
`filters.function_ids`	`string[]`	LinkedIn FUNCTION ids, e.g. "25" for Sales.
`filters.company_ids`	`FacetId[]`	Bare id string, or { id, text } for a display label.
`filters.past_company_ids`	`FacetId[]`
`filters.company_sizes`	`string[]`	Enum per item: self-employed, 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
`filters.industry_ids`	`FacetId[]`
`filters.location_ids`	`FacetId[]`	LinkedIn geo / REGION ids.
`filters.school_ids`	`FacetId[]`
`filters.years_of_experience`	`string[]`	Enum per item: "1" through "5".
`filters.years_at_current_company`	`string[]`	Enum per item: "1" through "5".
`filters.years_in_current_position`	`string[]`	Enum per item: "1" through "5".
`filters.first_name`	`string`
`filters.last_name`	`string`
`filters.posted_on_linkedin`	`boolean`
`filters.recently_changed_jobs`	`boolean`
`max_results`	`integer`	Default 25. 1 to 2,500; a sync call returns at most 100 results (`pagination.has_more` is true when more exist).

#Call it

cURL

curl -X POST "https://api.up2data.ai/v1/search/people" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "filters": {
    "titles": [
      "CTO"
    ],
    "keywords": "kubernetes"
  },
  "max_results": 10
}'

Python

import requests

url = "https://api.up2data.ai/v1/search/people"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "filters": {
        "titles": [
            "CTO"
        ],
        "keywords": "kubernetes"
    },
    "max_results": 10
}

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

Node

const url = "https://api.up2data.ai/v1/search/people";
const headers = {
  "X-API-Key": "YOUR_API_KEY",
  "Content-Type": "application/json",
};
const body = {
  "filters": {
    "titles": [
      "CTO"
    ],
    "keywords": "kubernetes"
  },
  "max_results": 10
};

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/search/people"
	body := bytes.NewBufferString(`{
  "filters": {
    "titles": [
      "CTO"
    ],
    "keywords": "kubernetes"
  },
  "max_results": 10
}`)
	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

{
  "data": {
    "results": [{
      "url": "https://www.linkedin.com/in/ACwAAAtrDxoBpU0UuxqsRapB-BUxVWrU38-8c0g",
      "full_name": "Tong Zhi",
      "location": { "city": "London", "region": "England", "country": "United Kingdom" },
      "positions": [{ "title": "Co-Founder & CTO", "company": "HireHarbour", "company_url": "https://www.linkedin.com/company/100124585", "linkedin_id": "100124585", "started_at": "2023-10", "ended_at": null, "description": "Helping businesses by finding experienced, high quality remote staff." }],
      "current_company": { "name": "HireHarbour", "url": "https://www.linkedin.com/company/100124585", "linkedin_id": "100124585", "title": "Co-Founder & CTO", "started_at": "2023-10" },
      "is_premium": true
    }],
    "pagination": { "returned": 10, "max_results": 10, "pages_scraped": 1, "has_more": true }
  },
  "meta": { "creditsUsed": 1, "creditsRemaining": 98418, "billed": true, "reason": "success", "requestId": "req_example", "latencyMs": 2800, "resolved_search_url": "https://www.linkedin.com/search/results/people/?origin=FACETED_SEARCH&keywords=kubernetes&titleFreeText=CTO" }
}

#Errors

Status	Type	When	Billed
400	`invalid_request`	Missing or empty filters, unknown filter, or bad enum value.	No
401	`invalid_api_key`	Missing, malformed, or revoked key.	No
402	`insufficient_credits`	Balance can't cover the page(s) requested.	No
429	`rate_limited`	Over the 300 requests/min limit, or the 20 searches/hour per-organization quota. 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.