# 快手 / Kuaishou / Kwai API - 热榜、搜索、评论、博主数据 (`socialdatax/socialdatax-kuaishou-data-api`) Actor

社媒数据助手 SocialDataX 提供的只读快手 / Kuaishou / Kwai data API，支持热榜 / hot list、作品搜索 / video search、作品详情 / video details、评论 / comments、评论回复 / comment replies、博主信息 / creator profiles 和博主作品列表 / creator videos。

- **URL**: https://apify.com/socialdatax/socialdatax-kuaishou-data-api.md
- **Developed by:** [SocialDataX](https://apify.com/socialdatax) (community)
- **Categories:** Social media, Videos, Developer tools
- **Stats:** 3 total users, 2 monthly users, 54.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 dataset items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## 快手 / Kuaishou / Kwai API - 搜索、详情、评论、博主、热榜数据

这是社媒数据助手 SocialDataX 的 Apify Actor 适配层，提供只读快手 / Kuaishou / Kwai data API。

Apify 用户无需配置 SocialDataX API Key；直接通过 Apify Console、Apify API、Dataset export 或自动化工作流运行即可。

支持能力：

- 作品搜索 / video search
- 作品详情 / video details
- 评论列表 / comments
- 评论回复 / comment replies
- 博主信息 / creator profiles
- 博主作品列表 / creator videos
- 热榜 / hot list

This Actor is a read-only, unofficial data API integration. It is not affiliated with Kuaishou or Kwai.

### Support / 联系我们

如果 run 失败、需要更高用量，或想接入批量数据工作流，请通过 SocialDataX support 联系我们：

- Website: <https://socialdatax.com/>

If a run fails, you need higher limits, or you want to discuss a bulk data workflow, contact SocialDataX support:

- Website: <https://socialdatax.com/>

### 选择字段

先选择 `operation`，再填写该 operation 需要的字段。Apify 表单里其它字段可以留空；即使误填了无关字段，Actor 也会忽略。

| Operation | 必填字段 | 可选字段 | 说明 |
| --- | --- | --- | --- |
| `search_videos` | `keyword` | `page_token`, `max_items`, `auto_paginate` | 按关键词搜索快手作品，默认会自动翻页直到达到 `max_items`。 |
| `search_hot_list` | 无 | `max_items` | 快手短视频热榜，请求一次并按 `max_items` 限制写入 Dataset。 |
| `get_video_detail` | `photo_id` 或 `url` 至少填一个 | 无 | 获取单个快手作品详情；两者都填时优先使用 `url`。 |
| `get_video_comments` | `photo_id` 或 `url` 至少填一个 | `page_token`, `max_items`, `auto_paginate` | 获取一级评论列表；两者都填时优先使用 `url`。 |
| `get_video_sub_comments` | `photo_id`, `comment_id` | `page_token`, `max_items`, `auto_paginate` | 获取某条一级评论下的回复。先运行 `get_video_comments`，从 Dataset 的 `comment_id` 字段复制 `has_replies = true` 的一级评论 ID。 |
| `get_user_info` | `user_id` 或 `profile_url` 至少填一个 | 无 | 获取博主信息；两者都填时优先使用 `profile_url`。 |
| `list_user_videos` | `user_id` 或 `profile_url` 至少填一个 | `page_token`, `max_items`, `auto_paginate` | 获取博主作品列表；两者都填时优先使用 `profile_url`。 |

### 字段填写建议 / Input tips

- `url`: 推荐直接粘贴快手作品链接、短链接或分享文案，适用于 `get_video_detail` 和 `get_video_comments`。`get_video_sub_comments` 不使用 `url`，请先跑 `get_video_comments` 再复制 Dataset 行里的真实 `photo_id + comment_id`。
- `profile_url`: 推荐直接粘贴快手主页链接、短链接或分享文案，适用于 `get_user_info` 和 `list_user_videos`。
- `photo_id`: 只填真实作品 ID；如果把作品链接或分享文案误填到 `photo_id`，Actor 会尽量自动按 `url` 处理。`get_video_sub_comments` 例外，它必须使用 `get_video_comments` Dataset 行里的真实 `photo_id`。
- `user_id`: 只填真实 `user_id` / `author_user_id`。不要填昵称、主页名称或快手号；如果只有主页链接或分享文案，请填 `profile_url`。
- `comment_id`: 只填 `get_video_comments` Dataset row 里的 `comment_id`。请选择 `has_replies = true` 的一级评论行，不要填评论内容、昵称或其它文本。

如果用户把作品链接填到博主类 operation、把主页链接填到作品类 operation，或在 `get_video_sub_comments` 的 `photo_id` 里粘贴作品链接/分享文案，Actor 会跳过 SocialDataX API 请求并在 `OUTPUT` 写入中英文 warning 和支持链接，避免因为明显可修正的输入问题直接失败。

### 输入示例

作品搜索：

```json
{
  "operation": "search_videos",
  "keyword": "露营",
  "max_items": 50,
  "auto_paginate": true
}
````

热榜：

```json
{
  "operation": "search_hot_list",
  "max_items": 50
}
```

作品详情：

```json
{
  "operation": "get_video_detail",
  "url": "https://www.kuaishou.com/short-video/3x3c333kuw4ppz6"
}
```

评论列表：

```json
{
  "operation": "get_video_comments",
  "url": "https://www.kuaishou.com/short-video/3xga9bnxzfggi29",
  "page_token": "",
  "max_items": 50,
  "auto_paginate": true
}
```

评论回复：

```json
{
  "operation": "get_video_sub_comments",
  "photo_id": "3xiiy5h354fxrky",
  "comment_id": "1110853192412",
  "page_token": "",
  "max_items": 50,
  "auto_paginate": true
}
```

`comment_id` 来自 `get_video_comments` 的 Dataset 结果。选择 `has_replies = true` 的一级评论行，复制该行的 `comment_id`。

博主信息：

```json
{
  "operation": "get_user_info",
  "profile_url": "https://www.kuaishou.com/profile/3x5ijbmydjhrcng"
}
```

博主作品列表：

```json
{
  "operation": "list_user_videos",
  "profile_url": "https://www.kuaishou.com/profile/3xn3uu4z6qqtvz4",
  "page_token": "",
  "max_items": 50,
  "auto_paginate": true
}
```

`max_items` 默认 `50`，最大 `1000`。`auto_paginate=false` 时只请求当前 `page_token`。热榜不需要分页参数，Actor 会请求一次，并按 `max_items` 限制写入 Dataset 的热榜条目数。

如果用户在 Apify run options 里设置了更低的 paid Dataset item 上限，Actor 会把列表类 `max_items` 自动裁剪到该上限，避免超预算请求过多页面。
如果该上限为 `0`，Actor 会直接结束并在 `OUTPUT` 写入 warning，不会请求 SocialDataX API。

### Apify 计划要求

持续使用需要 Apify paid plan。Apify free plan 用户有 5 次 SocialDataX API request 试用额度；每次请求一个接口页面计 1 次，`auto_paginate=true` 时每翻一页都会计入一次。试用额度用完后，请升级 Apify 计划继续使用。

Ongoing use requires an Apify paid plan. Free-plan users get a 5-request SocialDataX API trial. Each requested page counts as one request, so `auto_paginate=true` can consume multiple requests in one run.

### 输出

Actor 会把结果写入 Apify Dataset，适合 JSON、CSV、Excel / XLSX、JSONL 等格式导出。

列表类接口会为 `items[]` 中的每个元素写入一条扁平 dataset row：

```json
{
  "operation": "get_video_comments",
  "item_index": 1,
  "query_photo_id": "3xga9bnxzfggi29",
  "query_page_token": "",
  "query_max_items": 50,
  "query_auto_paginate": true,
  "photo_id": "3xga9bnxzfggi29",
  "comment_id": "1133183536984",
  "content": "为小敏的哥哥，嫂子点赞[赞][赞][赞][赞][祈祷][祈祷][祈祷][祈祷][祈祷]",
  "has_replies": false,
  "author_user_id": "3x58hkbxv2sgpje",
  "author_name": "反应神",
  "page_request_index": 1,
  "page_item_count": 20,
  "page_next_page_token": "next-token",
  "page_has_more": true
}
```

详情类接口会写入一条 dataset row。`author`、`video` 等常见对象会展开为 `author_*`、`video_*` 字段；图片和数组字段保留 JSON 值。

如果某一页 `items` 为空但仍有分页信息，Actor 会写入一条 `empty_page=true` 的 summary row，避免丢失 `next_page_token`。如果空页已经没有下一页，则不会写入 Dataset row。

如果 run 失败，`OUTPUT` 会保留一条轻量失败摘要，方便在 Apify 控制台里直接看到请求次数、状态码和简要错误信息。

### Apify API 调用

同步运行并直接获取 Dataset items：

```bash
curl -X POST "https://api.apify.com/v2/acts/socialdatax~socialdatax-kuaishou-data-api/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "search_videos",
    "keyword": "露营",
    "max_items": 50,
    "auto_paginate": true
  }'
```

Python client 示例：

```python
from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("socialdatax/socialdatax-kuaishou-data-api").call(run_input={
    "operation": "search_videos",
    "keyword": "露营",
    "max_items": 50,
    "auto_paginate": True,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
```

### 费用

Apify 用户按 Actor 页面展示的 Apify 价格和用量计费，不需要购买或配置 SocialDataX API Key。

# Actor input Schema

## `operation` (type: `string`):

先选择要调用的快手 / Kuaishou / Kwai 数据能力，然后只填写该 operation 需要的字段；无关字段会被忽略。持续使用需要 Apify paid plan；free plan 用户有 5 次 SocialDataX API request 试用额度。Choose the operation first, then fill only the fields used by that operation.

## `keyword` (type: `string`):

仅 operation=search\_videos 时必填；其它 operation 可留空。

## `photo_id` (type: `string`):

operation=get\_video\_detail、get\_video\_comments、get\_video\_sub\_comments 时使用；如果只有作品链接、短链接或分享文案，请直接填 url。详情和评论列表至少提供 photo\_id 或 url 之一，同时提供时优先使用 url。误填到 photo\_id 时，Actor 会尽量自动识别作品链接。评论回复必须使用 get\_video\_comments Dataset 行里的真实 photo\_id + comment\_id，不支持链接或分享文案。

## `url` (type: `string`):

operation=get\_video\_detail、get\_video\_comments 时至少提供 url 或 photo\_id 之一；同时提供时优先使用 url。推荐直接粘贴快手作品链接、短链接或分享文案。评论回复 get\_video\_sub\_comments 不使用 url；请先运行 get\_video\_comments，再复制 Dataset 行里的真实 photo\_id + comment\_id。

## `user_id` (type: `string`):

operation=get\_user\_info、list\_user\_videos 时至少提供 user\_id 或 profile\_url 之一；同时提供时优先使用 profile\_url。只填真实 user\_id，不要填昵称、主页名称或快手号；如果只有主页链接、短链接或分享文案，请直接填 profile\_url。误填到 user\_id 时，Actor 会尽量自动按 profile\_url 处理。

## `profile_url` (type: `string`):

operation=get\_user\_info、list\_user\_videos 时至少提供 profile\_url 或 user\_id 之一；同时提供时优先使用 profile\_url。强烈推荐直接粘贴快手主页链接、短链接或分享文案。

## `comment_id` (type: `string`):

仅 operation=get\_video\_sub\_comments 时必填。先运行 get\_video\_comments，在 Dataset 里找到 has\_replies = true 的一级评论行，复制该行的 comment\_id；不要填评论内容、昵称或其它文本。

## `page_token` (type: `string`):

搜索、评论、评论回复、博主作品列表继续翻页时传入上一页返回的完整 next\_page\_token；第一页留空。auto\_paginate=true 时通常不用手动填写。

## `max_items` (type: `integer`):

最多写入多少条 Dataset item。对搜索、评论、评论回复、博主作品列表用于限制自动翻页结果；对热榜用于限制本次导出的热榜条目数。较大的值可能触发多次 SocialDataX API request。

## `auto_paginate` (type: `boolean`):

开启后 Actor 会按 next\_page\_token 继续请求，直到达到 max\_items 或没有下一页。关闭时只请求当前 page\_token。每翻一页计 1 次 SocialDataX API request。When enabled, each page request counts as one SocialDataX API request.

## Actor input object example

```json
{
  "operation": "search_videos",
  "keyword": "露营",
  "max_items": 50,
  "auto_paginate": true
}
```

# Actor output Schema

## `dataset` (type: `string`):

Open flat result rows written to the default Apify Dataset. Export as JSON, CSV, Excel / XLSX, or JSONL.

## `keyValueStore` (type: `string`):

Open the default key-value store. The OUTPUT record contains operation, item count, request count, page-level response summaries, non-fatal warnings, and lightweight failure details when a run fails.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("socialdatax/socialdatax-kuaishou-data-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("socialdatax/socialdatax-kuaishou-data-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call socialdatax/socialdatax-kuaishou-data-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=socialdatax/socialdatax-kuaishou-data-api",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "快手 / Kuaishou / Kwai API - 热榜、搜索、评论、博主数据",
        "description": "社媒数据助手 SocialDataX 提供的只读快手 / Kuaishou / Kwai data API，支持热榜 / hot list、作品搜索 / video search、作品详情 / video details、评论 / comments、评论回复 / comment replies、博主信息 / creator profiles 和博主作品列表 / creator videos。",
        "version": "0.1",
        "x-build-id": "NWWiQWrE9Hhg2z28C"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/socialdatax~socialdatax-kuaishou-data-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-socialdatax-socialdatax-kuaishou-data-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/socialdatax~socialdatax-kuaishou-data-api/runs": {
            "post": {
                "operationId": "runs-sync-socialdatax-socialdatax-kuaishou-data-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/socialdatax~socialdatax-kuaishou-data-api/run-sync": {
            "post": {
                "operationId": "run-sync-socialdatax-socialdatax-kuaishou-data-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "operation"
                ],
                "properties": {
                    "operation": {
                        "title": "操作 / Operation",
                        "enum": [
                            "search_videos",
                            "search_hot_list",
                            "get_video_detail",
                            "get_user_info",
                            "list_user_videos",
                            "get_video_comments",
                            "get_video_sub_comments"
                        ],
                        "type": "string",
                        "description": "先选择要调用的快手 / Kuaishou / Kwai 数据能力，然后只填写该 operation 需要的字段；无关字段会被忽略。持续使用需要 Apify paid plan；free plan 用户有 5 次 SocialDataX API request 试用额度。Choose the operation first, then fill only the fields used by that operation.",
                        "default": "search_videos"
                    },
                    "keyword": {
                        "title": "关键词 / Keyword",
                        "type": "string",
                        "description": "仅 operation=search_videos 时必填；其它 operation 可留空。",
                        "default": "露营"
                    },
                    "photo_id": {
                        "title": "作品 ID / Photo ID",
                        "type": "string",
                        "description": "operation=get_video_detail、get_video_comments、get_video_sub_comments 时使用；如果只有作品链接、短链接或分享文案，请直接填 url。详情和评论列表至少提供 photo_id 或 url 之一，同时提供时优先使用 url。误填到 photo_id 时，Actor 会尽量自动识别作品链接。评论回复必须使用 get_video_comments Dataset 行里的真实 photo_id + comment_id，不支持链接或分享文案。"
                    },
                    "url": {
                        "title": "作品链接 / Video URL",
                        "type": "string",
                        "description": "operation=get_video_detail、get_video_comments 时至少提供 url 或 photo_id 之一；同时提供时优先使用 url。推荐直接粘贴快手作品链接、短链接或分享文案。评论回复 get_video_sub_comments 不使用 url；请先运行 get_video_comments，再复制 Dataset 行里的真实 photo_id + comment_id。"
                    },
                    "user_id": {
                        "title": "用户 ID / User ID",
                        "type": "string",
                        "description": "operation=get_user_info、list_user_videos 时至少提供 user_id 或 profile_url 之一；同时提供时优先使用 profile_url。只填真实 user_id，不要填昵称、主页名称或快手号；如果只有主页链接、短链接或分享文案，请直接填 profile_url。误填到 user_id 时，Actor 会尽量自动按 profile_url 处理。"
                    },
                    "profile_url": {
                        "title": "主页链接 / Profile URL",
                        "type": "string",
                        "description": "operation=get_user_info、list_user_videos 时至少提供 profile_url 或 user_id 之一；同时提供时优先使用 profile_url。强烈推荐直接粘贴快手主页链接、短链接或分享文案。"
                    },
                    "comment_id": {
                        "title": "一级评论 ID / Comment ID",
                        "type": "string",
                        "description": "仅 operation=get_video_sub_comments 时必填。先运行 get_video_comments，在 Dataset 里找到 has_replies = true 的一级评论行，复制该行的 comment_id；不要填评论内容、昵称或其它文本。"
                    },
                    "page_token": {
                        "title": "分页令牌 / Page token",
                        "type": "string",
                        "description": "搜索、评论、评论回复、博主作品列表继续翻页时传入上一页返回的完整 next_page_token；第一页留空。auto_paginate=true 时通常不用手动填写。"
                    },
                    "max_items": {
                        "title": "最大结果数 / Max items",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "最多写入多少条 Dataset item。对搜索、评论、评论回复、博主作品列表用于限制自动翻页结果；对热榜用于限制本次导出的热榜条目数。较大的值可能触发多次 SocialDataX API request。",
                        "default": 50
                    },
                    "auto_paginate": {
                        "title": "自动翻页 / Auto paginate",
                        "type": "boolean",
                        "description": "开启后 Actor 会按 next_page_token 继续请求，直到达到 max_items 或没有下一页。关闭时只请求当前 page_token。每翻一页计 1 次 SocialDataX API request。When enabled, each page request counts as one SocialDataX API request.",
                        "default": true
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```