DataXAPI 文档

21 个平台的 207 个接口,$0.0003 一次起,用同一套参数,返回同一种格式。下面 10 篇读一遍就够,之后任何接口去 API 参考里查。

更新于 2026-10-13 · 适用于 API v1在 ChatGPT 里打开在 Claude 里打开

三步快速开始

拿到 Key

用邮箱收到的 6 位验证码登录,或者用 Google 登录,不用密码。新账户可免费试用($0.10 额度),一个邮箱一次,按每次 $0.0020 够调 50 次。

第一把 Key 在注册完成后显示一次,当场复制,之后再也读不出来。把它放进环境变量 DATAXAPI_API_KEY,不要写进代码。

bash
export DATAXAPI_API_KEY="<your key>"

调一次

下面调的是 tiktok.videos.search,TikTok 视频搜索。别的接口都是同样的调法。

curl -G "https://api.dataxapi.com/v1/tiktok/videos/search" \
  --data-urlencode "query=space station" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.tiktok.videos.search(query="space station")
print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.tiktok.videos.search({ query: "space station" });
console.log(result.data.items);
dataxapi call tiktok.videos.search 'query=space station'

Python 和 TypeScript 两种写法用的是 SDK,最后一种用的是命令行。

这次调用的价格是每次 $0.0020。失败的调用不扣费。在 Playground 里跑一次:要先登录,花的是你自己的余额。

要知道的四样:

data.items

数据本身:一组标准对象,这里是 post。同一种对象在每个平台上字段都一样。

page.next_cursor

传回去当 cursor 就是下一页;没有下一页时是 null。每一页是单独的一次调用。

meta.unavailable

这个接口给不了的字段,各带原因。data.items 里没有、这里列着的字段,不是出了错。

meta.billing

这次扣了多少(amount),扣完余额还剩多少(balance_after)。

出错时换成同一种结构返回:code、message、charged、retry。比如余额不够是 insufficient_balance,charged 为 false,这次不扣钱。全部报错见错误码。

接进 AI

不想写代码,就把下面这句话复制给 Claude Code、Cursor、Codex 这类能动手的 AI。它会读说明、接好 MCP,之后你直接用中文问就行。

读 https://dataxapi.com/agents.md,在这个 agent 里帮我接好 DataXAPI。我的 API Key 是 dx_…,之后所有 DataXAPI 的调用都用它。

都能用
把 dx_… 换成你自己的 Key。控制台的接入 AI 页会连同一把专门给它用的 Key 一起复制好。

想自己配也行。MCP 地址是 https://api.dataxapi.com/mcp,接上后 AI 会拿到 5 个工具:

find按一句需求找到该用的接口。
describe一次看最多 5 个接口的全部:参数、字段、价格。
call调用一个接口,返回一页数据。
read_more24 小时内重读一份结果。
account余额、用量和每次调用的扣费。

完整的快速开始,带返回的逐项说明 →

全部指南

快速开始

拿一把 Key,调一次,读懂返回。新账户可免费试用($0.10 额度),同样的三步在 21 个平台上都一样。

认证

一次调用怎么认证:一个 Authorization 请求头带上你的 Key。一个账户最多 50 把 Key,每把可以设金额上限、到期时间和范围;Key 只在新建时显示一次。

请求与返回

每个接口是 /v1 下的一个路径,207 个接口用同一套参数名,每次返回都是同一种格式:code、request_id、data、page、warnings、meta。

翻页

一次调用取 1 页。把 page.next_cursor 放进 cursor 就是下一页;每页按一次调用单独计费,游标自己写明什么时候过期。

计费

一次调用多少钱($0.0003 到 $0.0400),什么时候扣、什么时候不扣,幂等键怎么保证重试不会扣第二次,预付余额怎么用。

报错

接口的全部 34 个错误码都在这一页:HTTP 状态码、含义、怎么办、扣没扣费、能不能重试。

限流

每个响应带 3 个限流头:额度、剩余、重置时间。超了立刻返回 429,不扣费,并写明要等多久。

SDK

TypeScript 和 Python SDK:207 个带类型的方法,每次调用自动带幂等键,按服务端允许的方式重试,翻页可设条数和花费上限,还能一次查多个平台。

命令行

dataxapi 命令行:8 个命令,找接口、看价格、调用、续读、查余额、跑任务、给本机的 AI 代理配好连接。退出码 0 到 5 告诉脚本下一步该做什么。

MCP 服务

一个远程 MCP 地址、5 个工具,让代理用上全部 207 个接口:地址、Claude Code、Codex、Cursor 各自的配置条目、每个工具做什么、怎么收费。

API 参考

21 个平台的 207 个接口。每个接口一页:参数、返回字段、一份录下来的真实返回、价格。

给 AI 代理和机器

同样的内容,做成了文件。本站每个页面都有 Markdown 版:网址结尾换成 .md。

代理最先读的索引

代理照着把自己接好的那一页

接口说明文件

给机器读的全部价格