LinkedIn 接口参考 | API 文档

# 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)

通过 13 个需要鉴权的 LinkedIn Web V2 接口查询用户与公司资料、帖子、职位详情、职位搜索结果和评论。

鉴权

在 Authorization 请求头中发送 API Hop API Key。可用性取决于已启用的网关和密钥权限；文档不代表生产环境已经开放。

请求

同步操作使用 GET 查询参数，不接受请求体。未知字段与重复的标量字段会被拒绝。只有标记为数组的字段允许重复键，例如 company_ids=1035&company_ids=1441。标识和游标须保留为字符串，不要将大整数标识转为 JavaScript 数字。可选空值会被省略。

计费

同步操作：用户资料、公司资料和帖子详情每次成功请求为 $0.008（8000 credits），其余 5 个操作为 $0.05（50000 credits）。这是默认客户价，账户专属价格优先。每次请求的分页单独计费，不按条目数收费。上游失败会释放预扣，结算失败不会触发第二次上游调用。

分页与限制

同步操作：用户帖子只返回最新 50 条：start 和 pagination_token 均无效，即使响应中存在令牌也不能翻页。公司帖子使用 start=0、50、100 等偏移，pagination_token 无效。职位搜索使用 start=0、25、50 等偏移。评论支持从 1 开始的 page 和 pagination_token。接口不会自动翻页，60 秒超时且不自动重试。供应商提示资源紧张可能造成间歇性失败。

范围

支持 8 个同步 Web V2 操作和 5 个异步任务操作。使用 POST 和包含 url 的 JSON 创建用户资料、公司资料或帖子详情任务，返回 HTTP 202 及字符串形式的平台十进制任务 ID。GET 状态和结果接口只允许本租户读取且免费；不存在、其他租户或其他产品的任务均返回 404。状态响应不含 result；完成前结果为 null。创建时预占，成功后仅结算一次，默认 $0.008 / 8000 credits；失败或 30 分钟超时释放预占。后台每 5 秒轮询，处理中响应含 Retry-After: 5。结果保存在平台任务中。只能使用平台 ID，不能传供应商任务 ID；提交结果不确定时不会自动重提。完成后数据位于 result.records。超出 JavaScript 安全范围的整数以十进制字符串存储并返回。示例仅用于说明，不是真实验收结果。

用户资料

web_v2-get_user_profile

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

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`url`	是	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/"

用户帖子

web_v2-get_user_posts

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

每次成功请求价格: $0.05 (50000 credits).

字段	必填	约束
`url`	是	LinkedIn 完整 URL; `string`
`type`	否	发帖、评论过的帖子或点赞过的帖子; `string`; `posts`, `comments`, `reactions`; 默认值: `posts`
`start`	否	偏移量；受具体接口限制; `integer`; >= 0
`pagination_token`	否	分页令牌；受具体接口限制; `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/"

公司资料

web_v2-get_company_profile

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

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`url`	是	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/"

公司帖子

web_v2-get_company_posts

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

每次成功请求价格: $0.05 (50000 credits).

字段	必填	约束
`url`	是	LinkedIn 完整 URL; `string`
`start`	否	偏移量；受具体接口限制; `integer`; >= 0
`pagination_token`	否	分页令牌；受具体接口限制; `string`
`sort_by`	否	排序方式; `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/"

职位详情

web_v2-get_job_detail

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

每次成功请求价格: $0.05 (50000 credits).

字段	必填	约束
`url`	是	LinkedIn 完整 URL; `string`
`include_skills`	否	包含技能要求; `boolean`; 默认值: `false`
`include_hiring_team`	否	包含招聘团队; `boolean`; 默认值: `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/"

职位搜索

web_v2-search_jobs

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

每次成功请求价格: $0.05 (50000 credits).

字段	必填	约束
`keywords`	否	搜索关键词; `string`
`geo_code`	否	地区标识；92000000 表示全球; `integer`; 精确整数标识
`date_posted`	否	发布时间过滤; `string`; `Any time`, `Past month`, `Past week`, `Past 24 hours`
`experience_levels`	否	经验级别; `string[]`; 重复查询键; `Internship`, `Entry level`, `Associate`, `Mid-Senior level`, `Director`, `Executive`
`company_ids`	否	公司标识; `integer[]`; 重复查询键; 精确整数标识
`title_ids`	否	职位名称标识; `integer[]`; 重复查询键; 精确整数标识
`onsite_remotes`	否	工作地点类型; `string[]`; 重复查询键; `On-site`, `Remote`, `Hybrid`
`functions`	否	职能; `string[]`; 重复查询键
`industries`	否	行业; `string[]`; 重复查询键
`job_types`	否	雇佣类型; `string[]`; 重复查询键; `Full-time`, `Part-time`, `Contract`, `Temporary`, `Internship`, `Volunteer`
`sort_by`	否	排序方式; `string`; `Most relevant`, `Most recent`
`easy_apply`	否	仅限便捷申请职位; `boolean`; 默认值: `false`
`under_10_applicants`	否	仅限申请人数少于 10 的职位; `boolean`; 默认值: `false`
`start`	否	偏移量；受具体接口限制; `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"

帖子详情

web_v2-get_post_detail

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

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`url`	是	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"

帖子评论

web_v2-get_post_comments

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

每次成功请求价格: $0.05 (50000 credits).

字段	必填	约束
`urn`	是	帖子 activity URN; `string`
`sort_by`	否	排序方式; `string`; `Most relevant`, `Most recent`
`page`	否	页码，从 1 开始; `integer`; >= 1
`pagination_token`	否	分页令牌；受具体接口限制; `string`
`share_urn`	否	分享帖子的 share URN; `string`

bash

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

创建用户资料任务

web_v2-create_user_profile_task

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

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`url`	是	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"}

创建公司资料任务

web_v2-create_company_profile_task

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

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`url`	是	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"}

创建帖子详情任务

web_v2-create_post_detail_task

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

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`url`	是	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"}

任务状态

web_v2-get_task_status

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

每次成功请求价格: $0 (0 credits).

字段	必填	约束
`task_id`	是	URL 路径中的平台任务 ID；十进制字符串，不是供应商 ID; `string`; 精确整数标识

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"}

任务结果

web_v2-get_task_result

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

每次成功请求价格: $0 (0 credits).

字段	必填	约束
`task_id`	是	URL 路径中的平台任务 ID；十进制字符串，不是供应商 ID; `string`; 精确整数标识

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"}

响应

同步操作：保留原始 JSON 的 code/data 结构与数字精度，各接口响应结构不同。HTTP 200 本身不代表成功：业务错误以及含 error/error_code 的错误记录会被拒绝。成功的空结果仍会计费。以下仅为说明性响应，不是真实验收结果。

json

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

错误

HTTP 400：参数无效；401：鉴权失败；402：余额不足；403：无网关权限；405：方法不支持；408：请求取消；429：限流；502/503/504：供应商故障、配置不可用或超时。排查时请保留 X-Request-Id。

来源

于 2026-10-31 核对官方 OpenAPI V5.3.2 与当前端点价格。来源证明接口契约和价格，不代表每个端点均已通过真实调用验收。

TikHub · OpenAPI · 价格