# LinkedIn Employees API

LinkedIn

Returns the people who work at a LinkedIn company now, from its Page link, name or ID. Each person has their name, profile link, LinkedIn ID, headline, location and photo. Narrow the list to a job title, such as engineers or recruiters, and page through it with the cursor. [Overview and pricing](https://socialtap.dev/apis/linkedin/employees/index.md)

GET `/v1/linkedin/employees`

## Example

cURL:

```shell
curl -G 'https://socialtap.dev/v1/linkedin/employees' \
  --data-urlencode 'handle=https://www.linkedin.com/company/anthropicresearch/' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.linkedin.employees.list({ handle: "https://www.linkedin.com/company/anthropicresearch/" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  handle: "https://www.linkedin.com/company/anthropicresearch/",
});
const res = await fetch(`https://socialtap.dev/v1/linkedin/employees?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/linkedin/employees",
    params={"handle": "https://www.linkedin.com/company/anthropicresearch/"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("handle", "https://www.linkedin.com/company/anthropicresearch/")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/linkedin/employees?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": [
    {
      "approximate_fields": [],
      "avatar_url": "https://media.licdn.com/dms/image/v2/D5603AQFwLCnw39ROPg/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1695169954151?e=1796256000&v=beta&t=uwr4fHS75sseHGYhHzJbZxId2uQI-ZF6wJ81hleYzNA",
      "banner_url": null,
      "bio": null,
      "category": null,
      "country_code": null,
      "created_at": null,
      "display_name": "Esin D.",
      "external_links": [],
      "id": "559361280",
      "is_private": null,
      "is_verified": null,
      "location": "United States",
      "metrics": {
        "follower_count": null,
        "following_count": null,
        "post_count": null,
        "total_like_count": null,
        "total_view_count": null
      },
      "platform": "linkedin",
      "platform_specific": {
        "linkedin": {
          "affiliated_pages": [],
          "certifications": [],
          "company_size": null,
          "connection_count": null,
          "courses": [],
          "education": [],
          "employee_count": null,
          "employees": [],
          "experience": [],
          "founded_year": null,
          "headline": "Research Scientist at Anthropic | prev. Postdoc at Stanford AI Lab | PhD at Cornell | Working on LLMs & safety.",
          "headquarters": null,
          "honors": [],
          "is_creator": null,
          "is_hiring": null,
          "is_influencer": null,
          "is_open_to_work": null,
          "kind": "member",
          "languages": [],
          "locations": [],
          "organization_type": null,
          "organizations": [],
          "patents": [],
          "projects": [],
          "publication_frequency": null,
          "publications": [],
          "reaction_type": null,
          "recommendation_count": null,
          "recommendations": [],
          "similar_pages": [],
          "similar_profiles": [],
          "skills": [],
          "specialties": [],
          "tagline": null,
          "test_scores": [],
          "volunteering": []
        }
      },
      "type": "person",
      "unknown_fields": [
        "external_links",
        "platform_specific.linkedin.experience",
        "platform_specific.linkedin.education"
      ],
      "url": "https://www.linkedin.com/in/esin-d-5403b4137",
      "username": "esin-d-5403b4137"
    },
    {
      "approximate_fields": [],
      "avatar_url": "https://media.licdn.com/dms/image/v2/D5603AQFqt_O-N6PKYw/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1672098827108?e=1796256000&v=beta&t=2mVoIqKU6m4ygtPNMaI7ZgcSp6ly1UhGSYaLcFnT8IE",
      "banner_url": null,
      "bio": null,
      "category": null,
      "country_code": null,
      "created_at": null,
      "display_name": "Jon Busbee",
      "external_links": [],
      "id": "394712148",
      "is_private": null,
      "is_verified": null,
      "location": "Greater Seattle Area",
      "metrics": {
        "follower_count": null,
        "following_count": null,
        "post_count": null,
        "total_like_count": null,
        "total_view_count": null
      },
      "platform": "linkedin",
      "platform_specific": {
        "linkedin": {
          "affiliated_pages": [],
          "certifications": [],
          "company_size": null,
          "connection_count": null,
          "courses": [],
          "education": [],
          "employee_count": null,
          "employees": [],
          "experience": [],
          "founded_year": null,
          "headline": "Talent @ Anthropic",
          "headquarters": null,
          "honors": [],
          "is_creator": null,
          "is_hiring": null,
          "is_influencer": null,
          "is_open_to_work": null,
          "kind": "member",
          "languages": [],
          "locations": [],
          "organization_type": null,
          "organizations": [],
          "patents": [],
          "projects": [],
          "publication_frequency": null,
          "publications": [],
          "reaction_type": null,
          "recommendation_count": null,
          "recommendations": [],
          "similar_pages": [],
          "similar_profiles": [],
          "skills": [],
          "specialties": [],
          "tagline": null,
          "test_scores": [],
          "volunteering": []
        }
      },
      "type": "person",
      "unknown_fields": [
        "external_links",
        "platform_specific.linkedin.experience",
        "platform_specific.linkedin.education"
      ],
      "url": "https://www.linkedin.com/in/jbusbee",
      "username": "jbusbee"
    },
    {
      "approximate_fields": [],
      "avatar_url": "https://media.licdn.com/dms/image/v2/D5603AQEBbKRi5UPLnA/profile-displayphoto-scale_100_100/B56Z3uNHhPJ4Ac-/0/1777817909927?e=1796256000&v=beta&t=xhwO9mO0TxMGfm7h5KEBWGQy6kRiVIF0mzJXen2pv2U",
      "banner_url": null,
      "bio": null,
      "category": null,
      "country_code": null,
      "created_at": null,
      "display_name": "Soo Lee",
      "external_links": [],
      "id": "181035837",
      "is_private": null,
      "is_verified": null,
      "location": "Seoul, South Korea",
      "metrics": {
        "follower_count": null,
        "following_count": null,
        "post_count": null,
        "total_like_count": null,
        "total_view_count": null
      },
      "platform": "linkedin",
      "platform_specific": {
        "linkedin": {
          "affiliated_pages": [],
          "certifications": [],
          "company_size": null,
          "connection_count": null,
          "courses": [],
          "education": [],
          "employee_count": null,
          "employees": [],
          "experience": [],
          "founded_year": null,
          "headline": "Head of Cloud Partnership, Korea | APAC Cloud Partnership Lead @ Anthropic",
          "headquarters": null,
          "honors": [],
          "is_creator": null,
          "is_hiring": null,
          "is_influencer": null,
          "is_open_to_work": null,
          "kind": "member",
          "languages": [],
          "locations": [],
          "organization_type": null,
          "organizations": [],
          "patents": [],
          "projects": [],
          "publication_frequency": null,
          "publications": [],
          "reaction_type": null,
          "recommendation_count": null,
          "recommendations": [],
          "similar_pages": [],
          "similar_profiles": [],
          "skills": [],
          "specialties": [],
          "tagline": null,
          "test_scores": [],
          "volunteering": []
        }
      },
      "type": "person",
      "unknown_fields": [
        "external_links",
        "platform_specific.linkedin.experience",
        "platform_specific.linkedin.education"
      ],
      "url": "https://www.linkedin.com/in/soo",
      "username": "soo"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "linkedin",
    "source": "vendor",
    "is_cached": false,
    "credits_charged": 5,
    "latency_ms": 1000,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "profile",
      "id": null,
      "url": "https://www.linkedin.com/company/anthropicresearch"
    },
    "credits_remaining": 9995,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened for display; real responses are complete.

> [!NOTE]
>
> **Good to know**
>
> - LinkedIn shows a company's people only to signed-in members, so a data partner reads them for every request.
> - The list is LinkedIn's people search for the company as a current employer: people who name it in their current position, the order LinkedIn ranks them in, which can change between calls. Walking it with the cursor may repeat or skip a person: the ID dedupes them.
> - LinkedIn's search serves the first thousand people of a company only: past them, page.end_reason is platform_limit. A title narrows the list to reach others.
> - LinkedIn hides some people, showing them as LinkedIn Member with no name, link or ID that opens them: they are left out, and the page's warning says how many.
> - A company LinkedIn doesn't know answers not_found.

## Authorizations

`x-api-key`stringheaderrequired

Your API key. [Authentication](https://socialtap.dev/docs/authentication/index.md)

## Query parameters

| Name | Type | Description | Example |
| --- | --- | --- | --- |
| `handle` required | `string`<br>max 2,048 chars | The company: its LinkedIn Page link (linkedin.com/company/\<name>, any tab of it), its name with or without company/ (company/anthropicresearch), or its numeric ID (1441, or linkedin.com/company/1441). A school's Page (school/\<name>) lists the people who name the school as their current employer. Names are case-insensitive. | `https://www.linkedin.com/company/anthropicresearch/` |
| `title` optional | `string`<br>max 100 chars | Only people whose current job title matches these words (engineer, head of sales, recruiter), as LinkedIn's people search matches titles. Case-insensitive. Omit it for everyone. | `engineer` |
| `limit` optional | `integer`<br>min 1<br>max 25 | Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. | `25` |
| `cursor` optional | `string` | page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page. | — |

`handle` takes LinkedIn profile links; another kind of link, or another platform's, fails free with [`invalid_input`](https://socialtap.dev/docs/errors/index.md#invalid_input). Unknown parameters are rejected with a suggestion, never ignored ([Requests](https://socialtap.dev/docs/requests/index.md)). `limit` and `cursor` page through the list: see Pagination.

**Parameters every endpoint accepts**

| Name | Type | Description | Example |
| --- | --- | --- | --- |
| `max_age` optional | `integer`<br>min 0 | Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. | — |
| `fields` optional | `string` | Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments\[\].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole. | — |

## Response

### 200

`{data, page, meta}`. `data` is an array of up to 25 [profile](https://socialtap.dev/resources/profile/index.md) objects, as LinkedIn's people search ranks them (relevance, not by date); `page` says how to get the next page; `meta` describes the request ([meta](https://socialtap.dev/docs/reference/index.md#meta)). Fields only LinkedIn has are under `platform_specific.linkedin`.

| Field | Type | Description |
| --- | --- | --- |
| `data[].platform` | `string` | Platform ID (tiktok, youtube, …). |
| `data[].id` | `string` | Platform-native account ID (string; YouTube UC…, Reddit t2_…). |
| `data[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].display_name` | `string` or `null` | Display name, channel title or page name; null when empty or not exposed. |
| `data[].url` | `string` (uri) | Canonical profile URL. |
| `data[].type` | `string` | Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown.<br>One of `person`, `organization`, `community`, `unknown` |
| `data[].bio` | `string` or `null` | Profile bio, channel description or page about text; null when empty or not exposed. |
| `data[].avatar_url` | `string` (uri) or `null` | Profile picture URL (largest available). Platform CDN URLs can expire within hours. |
| `data[].banner_url` | `string` (uri) or `null` | Header or cover image URL. |
| `data[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].is_private` | `boolean` or `null` | True when the account's posts are not public. |
| `data[].category` | `string` or `null` | Platform category label (e.g. Musician, Media & Entertainment), as shown; not normalized. Often set only for business or creator accounts. |
| `data[].external_links` | `object[]` | Links in the bio or channel links; \[\] if none or not exposed. |
| `data[].external_links[].url` | `string` (uri) | Link target, absolute (https:// is added where the platform stores the link without a scheme). |
| `data[].external_links[].title` | `string` or `null` | Link label shown by the platform. |
| `data[].location` | `string` or `null` | Self-declared location text. |
| `data[].country_code` | `string` or `null` | ISO 3166-1 alpha-2 country the platform states for the account. |
| `data[].created_at` | `string` (date-time) or `null` | Account creation or join date, RFC 3339 UTC (some platforms give only the day: see approximate_fields). |
| `data[].metrics` | `object` | Counts at fetch time; null = hidden or not exposed, 0 = zero. |
| `data[].metrics.follower_count` | `integer` or `null` | Followers or subscribers. |
| `data[].metrics.following_count` | `integer` or `null` | Accounts this profile follows. |
| `data[].metrics.post_count` | `integer` or `null` | Posts or videos as the platform counts them on the profile (for a private account, posts the caller cannot see). |
| `data[].metrics.total_like_count` | `integer` or `null` | Likes received across all of the profile's posts (not likes given). |
| `data[].metrics.total_view_count` | `integer` or `null` | Lifetime views across all of the profile's posts. |
| `data[].platform_specific` | `object` | Fields only this platform has, under its ID (platform_specific.\<platform>); each null when unknown. |
| `data[].platform_specific.linkedin` | `object` or `null` | A LinkedIn Page's or member's own fields. |
| `data[].platform_specific.linkedin.kind` | `string` or `null` | What the account is on LinkedIn: a company's Page (linkedin.com/company/…), a school's (/school/…), a showcase page, a company's page for one brand or product (/showcase/…), a member, a person (/in/…), or a newsletter members subscribe to (/newsletters/…). New values may be added; treat unknown values as other.<br>One of `company`, `school`, `showcase`, `member`, `newsletter` |
| `data[].platform_specific.linkedin.publication_frequency` | `string` or `null` | How often a newsletter is published, as LinkedIn shows it under its name (daily, weekly, biweekly or monthly); null for any other account, and when LinkedIn shows none. New values may be added; treat unknown values as other.<br>One of `daily`, `weekly`, `biweekly`, `monthly` |
| `data[].platform_specific.linkedin.tagline` | `string` or `null` | The Page's tagline, the line under its name; null when it has none, and for a member. |
| `data[].platform_specific.linkedin.organization_type` | `string` or `null` | The Page's organization type as LinkedIn shows it (Public Company, Privately Held, Nonprofit, Educational, Government Agency, Self-Employed, Partnership); null when not shown. |
| `data[].platform_specific.linkedin.company_size` | `object` or `null` | The Page's company size, the bucket of employees it declares (10,001+ is a lower bound with no upper bound); null when not shown. |
| `data[].platform_specific.linkedin.company_size.lower_bound` | `integer` | Inclusive lower bound. |
| `data[].platform_specific.linkedin.company_size.upper_bound` | `integer` or `null` | Inclusive upper bound; null when open-ended (e.g. ">1M"). Equal to lower_bound when exact. |
| `data[].platform_specific.linkedin.employee_count` | `integer` or `null` | Members who list the organization as their employer, exact as LinkedIn counts them; null when not shown. |
| `data[].platform_specific.linkedin.founded_year` | `integer` or `null` | The year the organization was founded, as its Page states it; null when not shown. |
| `data[].platform_specific.linkedin.specialties` | `string[]` | The Page's specialties, in its order; \[\] when it lists none. |
| `data[].platform_specific.linkedin.headquarters` | `object` or `null` | The Page's headquarters address; null when not shown. location is its city and region as one line. |
| `data[].platform_specific.linkedin.headquarters.street` | `string` or `null` | Street address; null when not shown. |
| `data[].platform_specific.linkedin.headquarters.city` | `string` or `null` | City; null when not shown. |
| `data[].platform_specific.linkedin.headquarters.region` | `string` or `null` | State, province or region, as written; null when not shown. |
| `data[].platform_specific.linkedin.headquarters.postal_code` | `string` or `null` | Postal code; null when not shown. |
| `data[].platform_specific.linkedin.headquarters.country_code` | `string` or `null` | ISO 3166-1 alpha-2 country code; null when not shown. |
| `data[].platform_specific.linkedin.locations` | `object[]` | The organization's locations as its Page lists them, the primary one first; \[\] when it lists none. |
| `data[].platform_specific.linkedin.locations[].address` | `string` | The address as the Page shows it, its lines joined with commas. |
| `data[].platform_specific.linkedin.locations[].is_primary` | `boolean` | True for the location the Page marks Primary. |
| `data[].platform_specific.linkedin.affiliated_pages` | `object[]` | Pages LinkedIn shows as affiliated with this one (its showcase pages, its parent or subsidiaries); \[\] when it shows none. |
| `data[].platform_specific.linkedin.affiliated_pages[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.affiliated_pages[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.affiliated_pages[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.affiliated_pages[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.affiliated_pages[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.affiliated_pages[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.affiliated_pages[].category` | `string` or `null` | The Page's industry, as the card shows it; null when not shown. |
| `data[].platform_specific.linkedin.affiliated_pages[].location` | `string` or `null` | The Page's headquarters city and region, as the card shows it; null when not shown. |
| `data[].platform_specific.linkedin.similar_pages` | `object[]` | Pages LinkedIn shows as similar to this one; \[\] when it shows none. |
| `data[].platform_specific.linkedin.similar_pages[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.similar_pages[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.similar_pages[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.similar_pages[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.similar_pages[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.similar_pages[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.similar_pages[].category` | `string` or `null` | The Page's industry, as the card shows it; null when not shown. |
| `data[].platform_specific.linkedin.similar_pages[].location` | `string` or `null` | The Page's headquarters city and region, as the card shows it; null when not shown. |
| `data[].platform_specific.linkedin.employees` | `object[]` | Members LinkedIn shows as working at the organization (the few its Page names logged out); \[\] when it names none. |
| `data[].platform_specific.linkedin.employees[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.employees[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.employees[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.employees[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.employees[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.employees[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.headline` | `string` or `null` | The member's headline, the line under their name; null when they have none, and for a Page. |
| `data[].platform_specific.linkedin.connection_count` | `integer` or `null` | The member's connections; LinkedIn shows any count above 500 as 500+, which is 500 here and listed in approximate_fields. Null when not shown, and for a Page. |
| `data[].platform_specific.linkedin.is_influencer` | `boolean` or `null` | True when LinkedIn marks the member as an influencer (its Top Voice badge beside the name); null for a Page. |
| `data[].platform_specific.linkedin.experience` | `object[]` | The member's positions, as their public profile lists them (current first, then past). Where LinkedIn hides the list from logged-out visitors, the current organization it still names, with title null; \[\] when it names none. |
| `data[].platform_specific.linkedin.experience[].title` | `string` or `null` | The position's title; null when not shown. |
| `data[].platform_specific.linkedin.experience[].company` | `object` or `null` | The organization, with its Page's link when it has one; null when not shown. |
| `data[].platform_specific.linkedin.experience[].company.id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.experience[].company.username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.experience[].company.display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.experience[].company.url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.experience[].company.avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.experience[].company.is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.experience[].started_on` | `string` or `null` | When the position started, as LinkedIn shows it: a year (2015) or a month (2015-03); null when not shown. |
| `data[].platform_specific.linkedin.experience[].ended_on` | `string` or `null` | When it ended, a year or a month; null while current (is_current) or when not shown. |
| `data[].platform_specific.linkedin.experience[].is_current` | `boolean` | True for a position LinkedIn shows as ongoing (to Present); false otherwise, including when no dates are shown. |
| `data[].platform_specific.linkedin.experience[].location` | `string` or `null` | Where it is, as written; null when not shown. |
| `data[].platform_specific.linkedin.experience[].description` | `string` or `null` | The member's description of it; null when none. |
| `data[].platform_specific.linkedin.experience[].skills` | `string[]` | The skills the member ties to the position, in their order; \[\] when they tie none. LinkedIn's logged-out page doesn't show them (unknown_fields names them then); a data partner's copy does (meta.source vendor). |
| `data[].platform_specific.linkedin.education` | `object[]` | The member's education, as their public profile lists it. Where LinkedIn hides the list from logged-out visitors, the school it still names, with degree null; \[\] when it names none. |
| `data[].platform_specific.linkedin.education[].school` | `object` or `null` | The school, with its Page's link when it has one; null when not shown. |
| `data[].platform_specific.linkedin.education[].school.id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.education[].school.username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.education[].school.display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.education[].school.url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.education[].school.avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.education[].school.is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.education[].degree` | `string` or `null` | The degree and field of study, as written; null when not shown. |
| `data[].platform_specific.linkedin.education[].started_on` | `string` or `null` | When it started, a year or a month; null when not shown. |
| `data[].platform_specific.linkedin.education[].ended_on` | `string` or `null` | When it ended, a year or a month; null when not shown. |
| `data[].platform_specific.linkedin.is_creator` | `boolean` or `null` | True when LinkedIn marks the member as a creator (creator mode); null for a Page. |
| `data[].platform_specific.linkedin.is_open_to_work` | `boolean` or `null` | True when the member shows LinkedIn's Open to Work frame, false when they don't; null when unknown (LinkedIn's logged-out page doesn't show it, a data partner's copy does: meta.source vendor) and for a Page. |
| `data[].platform_specific.linkedin.is_hiring` | `boolean` or `null` | True when the member shows LinkedIn's Hiring frame, false when they don't; null when unknown (as is_open_to_work) and for a Page. |
| `data[].platform_specific.linkedin.volunteering` | `object[]` | The member's volunteer experience, as their public profile lists it; \[\] when it lists none, and for a Page. |
| `data[].platform_specific.linkedin.volunteering[].role` | `string` or `null` | The member's role; null when not shown. |
| `data[].platform_specific.linkedin.volunteering[].organization` | `object` or `null` | The organization, with its Page's link when it has one; null when not shown. |
| `data[].platform_specific.linkedin.volunteering[].organization.id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.volunteering[].organization.username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.volunteering[].organization.display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.volunteering[].organization.url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.volunteering[].organization.avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.volunteering[].organization.is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.volunteering[].cause` | `string` or `null` | The cause, as LinkedIn names it (Economic Empowerment, Health, Education); null when not shown. |
| `data[].platform_specific.linkedin.volunteering[].started_on` | `string` or `null` | When it started, a year (2015) or a month (2015-03); null when not shown. |
| `data[].platform_specific.linkedin.volunteering[].ended_on` | `string` or `null` | When it ended, a year or a month; null while current (is_current) or when not shown. |
| `data[].platform_specific.linkedin.volunteering[].is_current` | `boolean` | True for a role LinkedIn shows as ongoing (to Present); false otherwise, including when no dates are shown. |
| `data[].platform_specific.linkedin.volunteering[].description` | `string` or `null` | The member's description of it; null when none. |
| `data[].platform_specific.linkedin.projects` | `object[]` | The member's projects, as their public profile lists them; \[\] when it lists none, and for a Page. |
| `data[].platform_specific.linkedin.projects[].title` | `string` | The project's name. |
| `data[].platform_specific.linkedin.projects[].url` | `string` (uri) or `null` | The project's link; null when it has none. |
| `data[].platform_specific.linkedin.projects[].started_on` | `string` or `null` | When it started, a year or a month; null when not shown. |
| `data[].platform_specific.linkedin.projects[].ended_on` | `string` or `null` | When it ended, a year or a month; null while ongoing or when not shown. |
| `data[].platform_specific.linkedin.projects[].description` | `string` or `null` | The member's description of it; null when none. |
| `data[].platform_specific.linkedin.projects[].contributors` | `object[]` | The other members LinkedIn lists as its creators; \[\] when it lists none. |
| `data[].platform_specific.linkedin.projects[].contributors[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.projects[].contributors[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.projects[].contributors[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.projects[].contributors[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.projects[].contributors[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.projects[].contributors[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.publications` | `object[]` | The member's publications, as their public profile lists them; \[\] when it lists none, and for a Page. |
| `data[].platform_specific.linkedin.publications[].title` | `string` | The publication's title. |
| `data[].platform_specific.linkedin.publications[].url` | `string` (uri) or `null` | The publication's link; null when it has none. |
| `data[].platform_specific.linkedin.publications[].publisher` | `string` or `null` | The publisher, as written; null when not shown. |
| `data[].platform_specific.linkedin.publications[].published_on` | `string` or `null` | When it was published: a day (2025-01-28), a month or a year; null when not shown. |
| `data[].platform_specific.linkedin.publications[].description` | `string` or `null` | The member's description of it; null when none. |
| `data[].platform_specific.linkedin.publications[].authors` | `object[]` | The other members LinkedIn lists as its authors; \[\] when it lists none. |
| `data[].platform_specific.linkedin.publications[].authors[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.publications[].authors[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.publications[].authors[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.publications[].authors[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.publications[].authors[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.publications[].authors[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.honors` | `object[]` | The member's honors and awards, as their public profile lists them; \[\] when it lists none, and for a Page. |
| `data[].platform_specific.linkedin.honors[].title` | `string` | The honor or award. |
| `data[].platform_specific.linkedin.honors[].issuer` | `string` or `null` | Who issued it, as written; null when not shown. |
| `data[].platform_specific.linkedin.honors[].issued_on` | `string` or `null` | When it was issued, a year or a month; null when not shown. |
| `data[].platform_specific.linkedin.honors[].description` | `string` or `null` | The member's description of it; null when none. |
| `data[].platform_specific.linkedin.certifications` | `object[]` | The member's licenses and certifications, as their public profile lists them; \[\] when it lists none, and for a Page. |
| `data[].platform_specific.linkedin.certifications[].name` | `string` | The license or certification. |
| `data[].platform_specific.linkedin.certifications[].url` | `string` (uri) or `null` | Its credential link; null when it has none. |
| `data[].platform_specific.linkedin.certifications[].issuer` | `object` or `null` | The issuing organization, with its Page's link when it has one; null when not shown. |
| `data[].platform_specific.linkedin.certifications[].issuer.id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.certifications[].issuer.username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.certifications[].issuer.display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.certifications[].issuer.url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.certifications[].issuer.avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.certifications[].issuer.is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.certifications[].issued_on` | `string` or `null` | When it was issued, a year or a month; null when not shown. |
| `data[].platform_specific.linkedin.certifications[].expires_on` | `string` or `null` | When it expires, a year or a month; null when it does not or when not shown. |
| `data[].platform_specific.linkedin.certifications[].credential_id` | `string` or `null` | The credential's ID, as the member wrote it; null when not shown. |
| `data[].platform_specific.linkedin.patents` | `object[]` | The member's patents, as their public profile lists them; \[\] when it lists none, and for a Page. |
| `data[].platform_specific.linkedin.patents[].title` | `string` | The patent's title. |
| `data[].platform_specific.linkedin.patents[].number` | `string` or `null` | Its number, as written (US 8,938,217); null when not shown. |
| `data[].platform_specific.linkedin.patents[].issued_on` | `string` or `null` | When it was issued: a day (2015-01-20), a month or a year; null when not shown. |
| `data[].platform_specific.linkedin.patents[].description` | `string` or `null` | Its description; null when none. |
| `data[].platform_specific.linkedin.patents[].inventors` | `object[]` | The other members LinkedIn lists as its inventors; \[\] when it lists none. |
| `data[].platform_specific.linkedin.patents[].inventors[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.patents[].inventors[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.patents[].inventors[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.patents[].inventors[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.patents[].inventors[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.patents[].inventors[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.courses` | `object[]` | The courses the member lists; \[\] when they list none, and for a Page. |
| `data[].platform_specific.linkedin.courses[].name` | `string` | The course. |
| `data[].platform_specific.linkedin.courses[].number` | `string` or `null` | Its course number, as written (BUS M 520); null when not shown. |
| `data[].platform_specific.linkedin.organizations` | `object[]` | The organizations the member lists (associations and memberships, not employers); \[\] when they list none, and for a Page. |
| `data[].platform_specific.linkedin.organizations[].name` | `string` | The organization. |
| `data[].platform_specific.linkedin.organizations[].position` | `string` or `null` | The member's position in it, as written; null when not shown. |
| `data[].platform_specific.linkedin.organizations[].started_on` | `string` or `null` | When it started, a year or a month; null when not shown. |
| `data[].platform_specific.linkedin.organizations[].ended_on` | `string` or `null` | When it ended, a year or a month; null while current (is_current) or when not shown. |
| `data[].platform_specific.linkedin.organizations[].is_current` | `boolean` | True for a membership LinkedIn shows as ongoing (to Present); false otherwise, including when no dates are shown. |
| `data[].platform_specific.linkedin.organizations[].description` | `string` or `null` | The member's description of it; null when none. |
| `data[].platform_specific.linkedin.languages` | `object[]` | The languages the member lists, with the proficiency they state; \[\] when they list none, and for a Page. |
| `data[].platform_specific.linkedin.languages[].name` | `string` | The language, as written. |
| `data[].platform_specific.linkedin.languages[].proficiency` | `string` or `null` | The proficiency the member states (Native or bilingual proficiency, Elementary proficiency); null when not shown. |
| `data[].platform_specific.linkedin.skills` | `string[]` | The skills the member lists, in their order; \[\] when they list none, and for a Page. |
| `data[].platform_specific.linkedin.test_scores` | `object[]` | The test scores the member lists (GMAT, SAT, a course's exam); \[\] when they list none, and for a Page. |
| `data[].platform_specific.linkedin.test_scores[].name` | `string` | The test, as the member names it (GMAT, ACT). |
| `data[].platform_specific.linkedin.test_scores[].score` | `string` or `null` | The score, as written (590, 3.9/4.0); null when not shown. |
| `data[].platform_specific.linkedin.test_scores[].taken_on` | `string` or `null` | When the member took it, a year or a month (2011-08); null when not shown. |
| `data[].platform_specific.linkedin.test_scores[].description` | `string` or `null` | The member's description of it; null when none. |
| `data[].platform_specific.linkedin.recommendations` | `object[]` | Recommendations the member received, the ones LinkedIn shows logged out (a few of recommendation_count); \[\] when it shows none, and for a Page. |
| `data[].platform_specific.linkedin.recommendations[].recommender` | `object` or `null` | The member who wrote it; null when LinkedIn does not name them. |
| `data[].platform_specific.linkedin.recommendations[].recommender.id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.recommendations[].recommender.username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.recommendations[].recommender.display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.recommendations[].recommender.url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.recommendations[].recommender.avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.recommendations[].recommender.is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.recommendations[].text` | `string` | The recommendation's text, as shown. |
| `data[].platform_specific.linkedin.recommendation_count` | `integer` or `null` | How many people have recommended the member, as LinkedIn counts them; null when not shown, and for a Page. |
| `data[].platform_specific.linkedin.similar_profiles` | `object[]` | Members LinkedIn shows as similar to this one (its People also viewed); \[\] when it shows none, and for a Page. |
| `data[].platform_specific.linkedin.similar_profiles[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data[].platform_specific.linkedin.similar_profiles[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data[].platform_specific.linkedin.similar_profiles[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data[].platform_specific.linkedin.similar_profiles[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data[].platform_specific.linkedin.similar_profiles[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data[].platform_specific.linkedin.similar_profiles[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data[].platform_specific.linkedin.similar_profiles[].headline` | `string` or `null` | The member's headline or current organization, as the card shows it; null when not shown. |
| `data[].platform_specific.linkedin.similar_profiles[].location` | `string` or `null` | The member's location, as the card shows it; null when not shown. |
| `data[].platform_specific.linkedin.reaction_type` | `string` or `null` | On a list of the accounts that reacted to a post (the LinkedIn Post Reactions API): how this one reacted, by LinkedIn's own name: like, praise (Celebrate), empathy (Love), appreciation (Support), interest (Insightful) or entertainment (Funny). Null on every other answer, and when the reaction's type isn't known. New values may be added; treat any other value as null.<br>One of `like`, `praise`, `empathy`, `appreciation`, `interest`, `entertainment` |
| `data[].approximate_fields` | `string[]` | JSON paths of values rounded by the platform or parsed from display text (e.g. metrics.follower_count). A list path (external_links) means the list may be incomplete. \[\] when all exact. |
| `data[].unknown_fields` | `string[]` | JSON paths of lists whose \[\] means unknown rather than none (a source that cannot see them); null already means unknown for every other field. \[\] when every list is known. |

not_found and private_or_unavailable are item-level: the request was fine, the item can't be returned.

### 400

400 Bad Request: 2 error codes. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `invalid_input` | 400 | No | A parameter is missing or malformed, or the link is not one this endpoint takes. | Fix the parameter named in param as the message says. For a link of the wrong kind, call an endpoint listed in details.endpoints, when there is one. |
| `invalid_cursor` | 400 | No | The cursor is malformed or expired, belongs to another endpoint, or came with other parameters than the request that returned it. | Repeat the original request without cursor to start the list again. |

### 401

401 Unauthorized: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `unauthorized` | 401 | No | The x-api-key header is missing, or its key is unknown or revoked. On the dashboard's routes: the session cookie is missing or expired. | Send a valid API key in the x-api-key header. No key yet? A person gets one at details.signup_url; an AI agent follows details.agent_auth_url. |

### 402

402 Payment Required: 2 error codes. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `insufficient_credits` | 402 | No | The account does not have enough credits for this request. | Have a person buy credits at details.purchase_url (or make them a checkout link with details.checkout), then repeat the request. Do not retry automatically. |
| `spend_limit_reached` | 402 | No | The API key reached its spend limit for this period. The account may still have credits. | Wait until details.resets_at, or raise the key's spend limit (PATCH /v1/api_keys/{id}). Do not retry automatically. |

### 403

403 Forbidden: 2 error codes. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `forbidden` | 403 | No | The API key is valid but may not make this request, and details.reason says why: the account is suspended, the key lacks the route's scope, has expired, or was used from an IP outside its allowlist, or a rotated key's previous secret was used for a call that needs the admin scope. A running job stops with it too when its account is suspended or the key that created it is revoked or expires. It is about the key, never the item: a private item is private_or_unavailable, also 403, so branch on the code. | Act on details.reason. suspended: contact [support](mailto:support@socialtap.dev). scope: use a key with details.required_scope. previous_secret: use the new secret. key_expired or key_revoked: create a new key. ip_not_allowed: call from an allowed IP. |
| `private_or_unavailable` | 403 | No | The item exists but is not public: it is private, age- or region-restricted, or needs a login to view. It shares 403 with forbidden (which is about the key), so branch on the code. | Only public items can be fetched. Do not retry. |

### 404

404 Not Found: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `not_found` | 404 | No | The item does not exist or was deleted. On GET /v1/requests/{id}/response: the response was not kept (details.reason says why). | Check the link or ID. Do not retry. |

### 429

429 Too Many Requests: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `rate_limited` | 429 | Yes, later | The account passed its runaway-protection ceiling: a high per-account limit that stops a broken client loop (plans have no rate limit). Requests without an API key (signup, the MCP server's tool listing and find_endpoint) are limited per IP address instead. It also stops an account whose failed requests in the last hour cost far more than its successful ones paid for: failures are free within a limit (the message says so), and successes raise it. | Wait the seconds in the retry-after header, then retry. If your steady traffic needs more, ask [support](mailto:support@socialtap.dev) to raise the ceiling; without an API key, send one. |

### 451

451: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `unavailable_for_legal_reasons` | 451 | No | We removed this item after a copyright notice or another legal request, so we don't return it. The request was free. A list leaves such items out instead, with an items_omitted warning. | Do not retry. The item stays unavailable unless the notice is withdrawn. |

### 500

500 Internal Error: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `internal` | 500 | Yes, later | An unexpected error on SocialTap's side. | Retry with backoff. If it keeps happening, contact [support](mailto:support@socialtap.dev) with the request_id. |

### 502

502 Bad Gateway: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `upstream_error` | 502 | Yes, later | The platform failed, or answered with something we could not read. | Retry with backoff. Failed requests are free. |

### 503

503 Unavailable: 2 error codes. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `upstream_blocked` | 503 | Yes, later | The platform refused every attempt, our own retries included. | Retry later with backoff. Failed requests are free. |
| `overloaded` | 503 | Yes, later | SocialTap was at capacity, or paused by its operators, and did not start the request. Nothing was fetched or charged. | Retry after the seconds in the retry-after header. Failed requests are free. |

## Pagination

Items come in pages, **as LinkedIn's people search ranks them (relevance, not by date)**. To get the next page, send **the same request plus `cursor`** set to `page.next_cursor` from the previous response. Keep every other parameter the same (limit, max_age and fields may change); anything else that differs is rejected. When `page.has_more` is `false` the walk is over, and `page.end_reason` says why: only `end` means you have every item (the others say the platform or a page cap stopped the walk early).

- **Order**: As LinkedIn's people search ranks them (relevance, not by date)
- **Page size**: Up to 25 employees (the default; `limit` lowers it)
- **Cursor lifetime**: 24 hours; don't store cursors
- **Price**: Per page, 5 credits

### The `page` object

| Field | Type | Description |
| --- | --- | --- |
| `page.has_more` | `boolean` | True when another page exists; then next_cursor is set. An empty page with has_more true is not the end. |
| `page.next_cursor` | `string` or `null` | Pass as cursor, with the same other parameters, to get the next page; null at the end. |
| `page.next_cursor_expires_at` | `string` (date-time) or `null` | When next_cursor stops working, RFC 3339 UTC; null at the end. Don't store cursors. |
| `page.end_reason` | `string` or `null` | Why there are no more pages; null while has_more is true. end: the list ended, or reached since/until. platform_limit: the platform stops serving further pages although the list goes on. max_pages: SocialTap's cap on pages in one walk. New values may be added. A short or empty page is not the end: only has_more false is.<br>One of `end`, `platform_limit`, `max_pages` |

### Next page

cURL: next page:

```shell
curl -G 'https://socialtap.dev/v1/linkedin/employees' \
  --data-urlencode 'handle=https://www.linkedin.com/company/anthropicresearch/' \
  --data-urlencode 'cursor=c1.EXAMPLE_CURSOR' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

- The price is per page: each successful page costs the same, whatever `limit` is and however many items it has. Empty pages are charged too (an empty page with `has_more: true` is not the end).
- A `limit` below 25 doesn't save credits: the next request serves the rest of the same platform page, which is fetched again and charged as a page each time, and items can shift between those requests if the platform changes the list. Omitting `limit` is the cheapest way to walk the list.
- Errors are free, including a rejected cursor.
- Pages served from the cache are free.
- An expired or altered cursor, or one sent with different parameters, fails with [`invalid_cursor`](https://socialtap.dev/docs/errors/index.md#invalid_cursor) (HTTP 400): Repeat the original request without cursor to start the list again.

[Pagination guide](https://socialtap.dev/docs/pagination/index.md)

## Pricing

From **5 credits** per page. Charged per successful page, whatever its number of items. Errors are free. The price depends on the source that produced the result, reported as `meta.source`.

| Source | Price per successful page | Per 1,000 pages |
| --- | --- | --- |
| Data partner `vendor` | 5 credits | $3.75–$9.83 |

**Balance, sources and what you were charged**

Your balance must be at least **5 credits** to start a request; with less, it is refused with [`insufficient_credits`](https://socialtap.dev/docs/errors/index.md#insufficient_credits) (HTTP 402) and costs nothing. Only that minimum is set aside when the request starts.

| meta.source | Source | What it means |
| --- | --- | --- |
| `vendor` | Data partner | A public-data partner's copy of the item, where the platform hides it from logged-out visitors: read live by the partner at request time. |

`meta.credits_charged` and the `x-credits-charged` header show what you paid. [How credits work](https://socialtap.dev/docs/credits/index.md) · [Packs](https://socialtap.dev/pricing/index.md)

Endpoint ID `linkedin.employees` · operationId `linkedin.employees.list` · [Product overview](https://socialtap.dev/apis/linkedin/employees/index.md)

---

[HTML version](https://socialtap.dev/docs/reference/linkedin/employees/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
