LinkedIn endpoint reference | API Docs

# LinkedIn endpoint reference

Read member and company profiles, posts, job details, job search results, and comments through 13 authenticated LinkedIn Web V2 endpoints.

## Authentication

Send your API Hop API key in the Authorization header. Access depends on enabled gateways and your key permissions; documentation does not confirm production availability.

## Requests

Synchronous operations use GET query parameters without a body. Unknown fields and duplicate scalar fields are rejected. Only fields marked as arrays accept repeated keys, for example company_ids=1035&company_ids=1441. Preserve IDs and cursors as strings; do not convert large identifiers to JavaScript numbers. Optional empty values are omitted.

## Billing

For synchronous operations: Member profiles, company profiles, and post details cost $0.008 (8000 credits) per successful request. The other five operations cost $0.05 (50000 credits). These are default customer prices; account-specific prices take precedence. Every requested page is billed separately, not per item. Upstream failures release the reservation. Settlement failures do not trigger another upstream call.

## Pagination and limits

For synchronous operations: Member posts return only the latest 50 items: start and pagination_token have no effect, even when the response contains a token. Company posts use start=0, 50, 100, ...; pagination_token has no effect. Job search uses start=0, 25, 50, .... Comments support page (starting at 1) and pagination_token. There is no automatic pagination. Requests time out after 60 seconds with no automatic retries. The supplier warns that resource constraints can cause intermittent failures.

## Scope

Eight synchronous Web V2 operations and five asynchronous task operations are available. Create profile, company, or post tasks with POST and a JSON url field. Creation returns HTTP 202 and a decimal platform task ID as a string. GET status and result reads require the same tenant and are free; unknown, foreign-tenant, and other-product tasks return 404. Status omits result; result is null before COMPLETED. Each task reserves its price at creation and charges once on success ($0.008 / 8000 credits by default). Failure or a 30-minute timeout releases the reservation. Background polling runs every 5 seconds; pending responses include Retry-After: 5. Results are stored in the platform job. Use the platform ID, never a supplier task ID. An uncertain submission is not automatically repeated. A completed task returns result.records. Integers beyond the JavaScript safe range are stored and returned as decimal strings. Examples are illustrative, not live acceptance results.

### Member profile

`web_v2-get_user_profile`

`GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/in/williamhgates/"
```

### Member posts

`web_v2-get_user_posts`

`GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |
| `type` | No | Posts, commented posts, or reacted posts; `string`; `posts`, `comments`, `reactions`; Default: `posts` |
| `start` | No | Offset; endpoint limits apply; `integer`; >= 0 |
| `pagination_token` | No | Pagination token; endpoint limits apply; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/in/williamhgates/"
```

### Company profile

`web_v2-get_company_profile`

`GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/company/microsoft/"
```

### Company posts

`web_v2-get_company_posts`

`GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |
| `start` | No | Offset; endpoint limits apply; `integer`; >= 0 |
| `pagination_token` | No | Pagination token; endpoint limits apply; `string` |
| `sort_by` | No | Sort order; `string`; `top`, `recent` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/company/microsoft/"
```

### Job details

`web_v2-get_job_detail`

`GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |
| `include_skills` | No | Include required skills; `boolean`; Default: `false` |
| `include_hiring_team` | No | Include hiring team; `boolean`; Default: `false` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/jobs/view/software-engineer-at-pave-4310512612/"
```

### Job search

`web_v2-search_jobs`

`GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `keywords` | No | Search keywords; `string` |
| `geo_code` | No | Geographic ID; 92000000 means worldwide; `integer`; Exact integer identifier |
| `date_posted` | No | Posting date filter; `string`; `Any time`, `Past month`, `Past week`, `Past 24 hours` |
| `experience_levels` | No | Experience levels; `string[]`; Repeated query key; `Internship`, `Entry level`, `Associate`, `Mid-Senior level`, `Director`, `Executive` |
| `company_ids` | No | Company IDs; `integer[]`; Repeated query key; Exact integer identifier |
| `title_ids` | No | Job title IDs; `integer[]`; Repeated query key; Exact integer identifier |
| `onsite_remotes` | No | Workplace types; `string[]`; Repeated query key; `On-site`, `Remote`, `Hybrid` |
| `functions` | No | Job functions; `string[]`; Repeated query key |
| `industries` | No | Industries; `string[]`; Repeated query key |
| `job_types` | No | Employment types; `string[]`; Repeated query key; `Full-time`, `Part-time`, `Contract`, `Temporary`, `Internship`, `Volunteer` |
| `sort_by` | No | Sort order; `string`; `Most relevant`, `Most recent` |
| `easy_apply` | No | Easy Apply only; `boolean`; Default: `false` |
| `under_10_applicants` | No | Fewer than 10 applicants only; `boolean`; Default: `false` |
| `start` | No | Offset; endpoint limits apply; `integer`; >= 0 |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keywords=data analyst" \
  --data-urlencode "company_ids=1035" \
  --data-urlencode "company_ids=1441"
```

### Post details

`web_v2-get_post_detail`

`GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"
```

### Post comments

`web_v2-get_post_comments`

`GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `urn` | Yes | Post activity URN; `string` |
| `sort_by` | No | Sort order; `string`; `Most relevant`, `Most recent` |
| `page` | No | Page number, starting at 1; `integer`; >= 1 |
| `pagination_token` | No | Pagination token; endpoint limits apply; `string` |
| `share_urn` | No | Share URN for shared posts; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "urn=7267273010393358336"
```

### Create member profile task

`web_v2-create_user_profile_task`

`POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/in/williamhgates/"}'
```

```http
HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
```

### Create company profile task

`web_v2-create_company_profile_task`

`POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/company/microsoft/"}'
```

```http
HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
```

### Create post detail task

`web_v2-create_post_detail_task`

`POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"}'
```

```http
HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
```

### Task status

`web_v2-get_task_status`

`GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id`

Price per successful request: **$0** (0 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `task_id` | Yes | Platform task ID in the URL path; decimal string, not a supplier ID; `string`; Exact integer identifier |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```http
HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING"},"requestId":"example-request"}
```

### Task result

`web_v2-get_task_result`

`GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result`

Price per successful request: **$0** (0 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `task_id` | Yes | Platform task ID in the URL path; decimal string, not a supplier ID; `string`; Exact integer identifier |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080/result" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```http
HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
```

```json
{"success":true,"data":{"id":"3850699893338385742","status":"COMPLETED","result":{"records":[]}},"requestId":"example-request"}
```

## Responses

For synchronous operations: The native JSON code/data envelope and numeric precision are preserved. Response shapes vary by operation. HTTP 200 alone is not success: business errors, including error/error_code records, are rejected. A successful empty result is billable. This is an illustrative response, not a live acceptance result.

```json
{"code":200,"data":[]}
```

## Errors

HTTP 400: invalid parameters; 401: invalid authentication; 402: insufficient credit; 403: denied gateway access; 405: unsupported method; 408: cancellation; 429: rate limit; 502/503/504: supplier failure, unavailable configuration, or timeout. Keep X-Request-Id for troubleshooting.

## Sources

Checked on 2026-10-31 against the official OpenAPI V5.3.2 and current endpoint prices. These sources describe the contract and prices, not successful live verification of every endpoint.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

Read member and company profiles, posts, job details, job search results, and comments through 13 authenticated LinkedIn Web V2 endpoints.

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`url`	Yes	Full LinkedIn URL; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/in/williamhgates/"

Member posts

web_v2-get_user_posts

GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts

Price per successful request: $0.05 (50000 credits).

Field	Required	Contract
`url`	Yes	Full LinkedIn URL; `string`
`type`	No	Posts, commented posts, or reacted posts; `string`; `posts`, `comments`, `reactions`; Default: `posts`
`start`	No	Offset; endpoint limits apply; `integer`; >= 0
`pagination_token`	No	Pagination token; endpoint limits apply; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/in/williamhgates/"

Company profile

web_v2-get_company_profile

GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`url`	Yes	Full LinkedIn URL; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/company/microsoft/"

Company posts

web_v2-get_company_posts

GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts

Price per successful request: $0.05 (50000 credits).

Field	Required	Contract
`url`	Yes	Full LinkedIn URL; `string`
`start`	No	Offset; endpoint limits apply; `integer`; >= 0
`pagination_token`	No	Pagination token; endpoint limits apply; `string`
`sort_by`	No	Sort order; `string`; `top`, `recent`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/company/microsoft/"

Job details

web_v2-get_job_detail

GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail

Price per successful request: $0.05 (50000 credits).

Field	Required	Contract
`url`	Yes	Full LinkedIn URL; `string`
`include_skills`	No	Include required skills; `boolean`; Default: `false`
`include_hiring_team`	No	Include hiring team; `boolean`; Default: `false`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/jobs/view/software-engineer-at-pave-4310512612/"

Job search

web_v2-search_jobs

GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search

Price per successful request: $0.05 (50000 credits).

Field	Required	Contract
`keywords`	No	Search keywords; `string`
`geo_code`	No	Geographic ID; 92000000 means worldwide; `integer`; Exact integer identifier
`date_posted`	No	Posting date filter; `string`; `Any time`, `Past month`, `Past week`, `Past 24 hours`
`experience_levels`	No	Experience levels; `string[]`; Repeated query key; `Internship`, `Entry level`, `Associate`, `Mid-Senior level`, `Director`, `Executive`
`company_ids`	No	Company IDs; `integer[]`; Repeated query key; Exact integer identifier
`title_ids`	No	Job title IDs; `integer[]`; Repeated query key; Exact integer identifier
`onsite_remotes`	No	Workplace types; `string[]`; Repeated query key; `On-site`, `Remote`, `Hybrid`
`functions`	No	Job functions; `string[]`; Repeated query key
`industries`	No	Industries; `string[]`; Repeated query key
`job_types`	No	Employment types; `string[]`; Repeated query key; `Full-time`, `Part-time`, `Contract`, `Temporary`, `Internship`, `Volunteer`
`sort_by`	No	Sort order; `string`; `Most relevant`, `Most recent`
`easy_apply`	No	Easy Apply only; `boolean`; Default: `false`
`under_10_applicants`	No	Fewer than 10 applicants only; `boolean`; Default: `false`
`start`	No	Offset; endpoint limits apply; `integer`; >= 0

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keywords=data analyst" \
  --data-urlencode "company_ids=1035" \
  --data-urlencode "company_ids=1441"

Post details

web_v2-get_post_detail

GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`url`	Yes	Full LinkedIn URL; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"

Post comments

web_v2-get_post_comments

GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments

Price per successful request: $0.05 (50000 credits).

Field	Required	Contract
`urn`	Yes	Post activity URN; `string`
`sort_by`	No	Sort order; `string`; `Most relevant`, `Most recent`
`page`	No	Page number, starting at 1; `integer`; >= 1
`pagination_token`	No	Pagination token; endpoint limits apply; `string`
`share_urn`	No	Share URN for shared posts; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "urn=7267273010393358336"

Create member profile task

web_v2-create_user_profile_task

POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`url`	Yes	Full LinkedIn URL; `string`

bash

curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/in/williamhgates/"}'

http

HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}

Create company profile task

web_v2-create_company_profile_task

POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`url`	Yes	Full LinkedIn URL; `string`

bash

curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/company/microsoft/"}'

http

HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}

Create post detail task

web_v2-create_post_detail_task

POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`url`	Yes	Full LinkedIn URL; `string`

bash

curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"}'

http

HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}

Task status

web_v2-get_task_status

GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id

Price per successful request: $0 (0 credits).

Field	Required	Contract
`task_id`	Yes	Platform task ID in the URL path; decimal string, not a supplier ID; `string`; Exact integer identifier

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080" \
  -H "Authorization: Bearer YOUR_API_KEY"

http

HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING"},"requestId":"example-request"}

Task result

web_v2-get_task_result

GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result

Price per successful request: $0 (0 credits).

Field	Required	Contract
`task_id`	Yes	Platform task ID in the URL path; decimal string, not a supplier ID; `string`; Exact integer identifier

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080/result" \
  -H "Authorization: Bearer YOUR_API_KEY"

http

HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}

json

{"success":true,"data":{"id":"3850699893338385742","status":"COMPLETED","result":{"records":[]}},"requestId":"example-request"}

Responses

json

{"code":200,"data":[]}

Errors

Sources

Checked on 2026-10-31 against the official OpenAPI V5.3.2 and current endpoint prices. These sources describe the contract and prices, not successful live verification of every endpoint.

TikHub · OpenAPI · Prices