DataXAPI 文档
21 个平台的 207 个接口,$0.0003 一次起,用同一套参数,返回同一种格式。下面 10 篇读一遍就够,之后任何接口去 API 参考里查。
三步快速开始
拿到 Key
用邮箱收到的 6 位验证码登录,或者用 Google 登录,不用密码。新账户可免费试用($0.10 额度),一个邮箱一次,按每次 $0.0020 够调 50 次。
第一把 Key 在注册完成后显示一次,当场复制,之后再也读不出来。把它放进环境变量 DATAXAPI_API_KEY,不要写进代码。
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 里跑一次:要先登录,花的是你自己的余额。
要知道的四样:
数据本身:一组标准对象,这里是 post。同一种对象在每个平台上字段都一样。
传回去当 cursor 就是下一页;没有下一页时是 null。每一页是单独的一次调用。
这个接口给不了的字段,各带原因。data.items 里没有、这里列着的字段,不是出了错。
这次扣了多少(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。