---
title: "查询异步任务状态/Get async task status"
method: GET
path: "/api/v1/linkedin/web_v2/async/get_task_status"
tags: ["LinkedIn-Web-V2-API"]
---

# 查询异步任务状态/Get async task status

`GET /api/v1/linkedin/web_v2/async/get_task_status`

## Request

- Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tikhub.io/api/v1/linkedin/web_v2/async/get_task_status`
- Auth: HTTP bearer

> ⚠️ **注意 / Note**
>
> - **本接口不计费。** 响应 JSON 中的 `message` / `message_zh` 是全局默认文案
>   （「本次请求将被计费」），对本接口不适用，请忽略。
> - **有 RPS 限流，请按每秒 1 次的频率轮询。** 超出路由限流会返回 429
>   （响应头 `Retry-After: 1`）；限流按「用户 + 路由」单独计算。
>
> - **This endpoint is free of charge.** The `message` / `message_zh` fields in
>   the response JSON carry a global default notice ("this request will incur a
>   charge") that does **not** apply here — please ignore them.
> - **This endpoint is rate limited — poll at no more than 1 request per
>   second.** Exceeding the route's limit returns 429 with a `Retry-After: 1`
>   header. The limit is tracked per user per route.

# [中文]
### 用途:
- 查询异步任务的执行状态。本端点不计费，三个创建任务端点通用。
- `ready` 为 `true` 时即可调用 `/async/get_task_result` 取回数据。
- 若只关心结果，也可以直接轮询 `/async/get_task_result`：未就绪时它会
  返回 `ready = false`，不必先查状态。

### 参数:
- task_id: 创建任务时返回的 task_id（形如 `sd_xxxxxxxxxxxxxxxxxx`）。

### 返回:
- task_id: 任务 id；
  ready: 结果是否已就绪（布尔值）；
  status: 任务状态（如 starting / running / ready / failed）；
  record_count: 已抓取到的记录数（就绪后出现）；
  error_count: 抓取失败的记录数（就绪后出现）；
  running_time: 已运行时长（毫秒，运行中出现）；
  collection_duration: 总采集耗时（毫秒，就绪后出现）。
- task_id 格式非法、不存在或已过期（超过 30 天）时返回 400。

# [English]
### Purpose:
- Check the status of an async task. This endpoint is free and is shared by
  all three task-creation endpoints.
- Once `ready` is `true`, call `/async/get_task_result` to fetch the data.
- If you only care about the data, you may poll `/async/get_task_result`
  directly: it returns `ready = false` while the task is still running, so
  checking the status first is optional.

### Parameters:
- task_id: The task_id returned on creation (looks like
  `sd_xxxxxxxxxxxxxxxxxx`).

### Returns:
- task_id: the task id;
  ready: whether the result is ready (boolean);
  status: task status (e.g. starting / running / ready / failed);
  record_count: number of records scraped (present once ready);
  error_count: number of failed records (present once ready);
  running_time: elapsed time in ms (present while running);
  collection_duration: total collection time in ms (present once ready).
- Returns 400 if the task_id is malformed, does not exist, or has expired
  (over 30 days).

# [示例/Example]
task_id = "sd_mvt2xl972bp4a77ncc"

## Query parameters

- `task_id` string, required: 创建任务时返回的 task_id/The task_id returned on creation

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-29** `59e32b4f0c12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/linkedin/web_v2/async/get_task_status/get.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)