SDK：Python 和 TypeScript（即将推出）

官方 Python 和 TypeScript SDK 正在准备：每个接口一个有类型的方法，每次调用自动带幂等键，按每个错误的 retry 建议自动重试，翻页迭代器带花费上限。目前还没有发布，所以今天没有可安装的包；发布当天这里会写上安装命令。

在那之前

接口就是普通 HTTPS 加一个请求头，任何 HTTP 库都能用。每个接口页都有可直接复制的 cURL、Python（requests）和 TypeScript（fetch）示例。所有返回的结构见请求说明。

import os, requests

r = requests.get(
    "https://api.okdata.online/v1/douyin/trends/list",
    headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
    timeout=60,
)
body = r.json()
print(body["code"], body["meta"]["billing"]["amount"])

生成客户端

openapi.json 是覆盖所有接口、参数和返回结构的完整 OpenAPI 3.1 描述，任何 OpenAPI 生成器都能用它生成你所用语言的有类型客户端。目录一变它就会重新生成。

给 AI 智能体

智能体用不着 SDK：接上 MCP 服务，或者给它装 Agent Skills。