ITAPI 开发文档（来源：https://itapi.top/developer/） 导出时间：2026-10-18 10:13:53 ======================================== 开发文档 本站提供四个「站点级接口」，让开发者可以程序化地获取接口清单、搜索接口、查看接口详情和站点统计数据。 站点概况 项目 | 说明 接口总数 | 468 个（实时） 分类 | 数据查询、图片壁纸、视频影视、社交平台、游戏娱乐、文案语录、实用工具、音乐音频、文本工具、AI 对话、图片处理 是否需要注册 | 不需要，全部免费直接调用 协议 | 同时支持 HTTP 和 HTTPS 请求方式 | 以 GET 为主，POST 也支持 返回格式 | {"code":200,"msg":"success","data":{...}} 跨域 | 接口已开启 CORS，浏览器里可直接 fetch 限流 | 60 次/分钟 · 1000 次/小时（按 IP） 通用错误码 code | 说明 200 | 成功 400 | 参数缺失或格式不对 401 | 缺少或无效的密钥（该接口需要密钥时） 403 | 密钥已停用 / IP 被封禁 / 密钥无权调用该接口 404 | 接口不存在 429 | 请求太频繁，触发了限流 500 | 接口执行失败 502 / 503 / 504 | 上游无响应 / 接口维护中 / 上游超时 ① 获取接口清单 拿到本站全部接口的名字和请求地址，用来拼出你真正要调用的那个接口。 GET 复制 https://itapi.top/openapi/list 请求参数 参数名 | 类型 | 必填 | 说明 n | int | 可选 | 页码，从 1 开始，默认 1 size | int | 可选 | 每页条数，默认 50，最大 500 cat | string | 可选 | 按分类筛选，如 文案语录 simple | int | 可选 | 传 1 只返回名字+地址 返回字段 字段 | 类型 | 说明 total | int | 当前筛选条件下的接口总数 site_total | int | 全站接口总数（不受筛选影响） n / size / pages | int | 当前页码 / 每页条数 / 总页数 categories[] | array | 每个分类的名字和数量 apis[].slug | string | 接口标识（查详情、拼地址都用它） apis[].name | string | 接口名字 apis[].url | string | 接口请求地址，拿到就能直接调 apis[].method | string | 请求方法 响应示例 200 OK 复制 { "code": 200, "msg": "success", "data": { "total": 468, "site_total": 468, "n": 1, "size": 50, "pages": 10, "categories": [ {"name": "数据查询", "count": 27}, {"name": "音乐音频", "count": 23} ], "apis": [ { "slug": "demo", "name": "示例接口", "category": "实用工具", "method": "GET", "path": "/api/demo", "url": "https://itapi.top/api/demo", "type": "proxy", "need_key": false, "description": "示例接口的说明", "docs": "https://itapi.top/docs/demo/" } ] } } 代码示例 cURL curl "https://itapi.top/openapi/list?n=1&size=200" JavaScript const res = await fetch("https://itapi.top/openapi/list?n=1&size=200"); const data = (await res.json()).data; console.log(`本站共 ${data.total} 个接口`); data.apis.forEach(a => console.log(a.name, "->", a.url)); Python import requests r = requests.get("https://itapi.top/openapi/list", params={"n": 1, "size": 200}, timeout=10) data = r.json()["data"] print(f"本站共 {data['total']} 个接口") for api in data["apis"]: print(api["name"], "->", api["url"]) ② 搜索接口 按关键词搜索接口，返回格式与「获取接口清单」完全一致，可以直接拿结果里的 slug 去调「获取接口详情」。 GET 复制 https://itapi.top/openapi/search?q=关键词 请求参数 参数名 | 类型 | 必填 | 说明 q | string | 必填 | 搜索关键词。匹配接口名、标识、说明、分类；也支持 keywords / keyword / kw / s n / size / cat / simple | — | 可选 | 与「获取接口清单」相同 响应示例 与「获取接口清单」完全相同，只多一个 keyword 字段回显你搜的词。 代码示例 JavaScript /* 1. 搜索 */ const list = (await (await fetch("https://itapi.top/openapi/search?q=" + encodeURIComponent("语录"))).json()).data; console.log(`搜到 ${list.total} 个接口`); list.apis.forEach(a => console.log(a.name, a.url)); /* 2. 拿第一个的 slug 去查详情 */ const info = (await (await fetch("https://itapi.top/openapi/info?slug=" + list.apis[0].slug)).json()).data; console.log(info.name, info.method, info.request_example); ③ 获取接口详情 用 slug 或名字，拿到某个接口的请求地址、请求参数、返回信息、请求方法。 GET 复制 https://itapi.top/openapi/info?slug=demo 请求参数 参数名 | 类型 | 必填 | 说明 slug | string | 三选一 | 接口标识（最准确） name | string | 三选一 | 接口名字，支持模糊 s | string | 三选一 | slug 的简写别名 返回字段 字段 | 类型 | 说明 name / slug / category | string | 名字 / 标识 / 分类 method | string | 请求方法（GET / POST / ANY） url | string | 请求地址 need_key | bool | 是否需要密钥 description | string | 接口说明 params[] | array | 请求参数：name / type / required / desc / sample request_example | string | 用示例值拼好的可直接请求的地址 response_fields[] | array | 返回字段说明（部分接口未填，则为空数组） response_example | string | 真实返回示例 docs | string | 该接口的网页版详情页地址 响应示例 200 OK 复制 { "code": 200, "msg": "success", "data": { "slug": "demo", "name": "示例接口", "category": "实用工具", "method": "GET", "type": "proxy", "url": "https://itapi.top/api/demo", "path": "/api/demo", "need_key": false, "status": "启用", "description": "示例接口的说明", "params": [ {"name": "text", "type": "string", "required": true, "desc": "要处理的文本", "sample": "hello"} ], "request_example": "https://itapi.top/api/demo?text=hello", "response_fields": [ {"name": "code", "type": "int", "desc": "状态码"} ], "response_example": "{\"code\":200,\"msg\":\"success\",\"data\":{...}}", "example_status": "200 OK", "docs": "https://itapi.top/docs/demo/" } } ④ 站点数据统计 获取本站的接口总数，以及今日调用量和累计调用量。统计只记录调用次数，不包含成功率、耗时或访客 IP。 GET 复制 https://itapi.top/openapi/stats 请求参数 无需任何参数。 返回字段 字段 | 类型 | 说明 apis_total | int | 站点接口总数 calls_today | int | 今日调用数（自然日 00:00 起累计） calls_today_text | string | 今日调用数（大数会简写，如 2.1k） calls_total | int | 累计总调用数 calls_total_text | string | 总调用数（简写，如 217.7k） updated_at | string | 本次返回数据的生成时间（实时统计） 响应示例 200 OK 复制 { "code": 200, "msg": "success", "data": { "apis_total": 468, "calls_today": 354, "calls_today_text": "354", "calls_total": 217675, "calls_total_text": "217.7k", "updated_at": "2026-10-18 10:13:53" } } 完整使用流程 三步走：先拿清单（或搜索）→ 再查详情 -> 最后拼参数调用。 PHP 完整示例 {$a['url']}\n"; } /* 2. 查详情 */ $slug = $list['apis'][0]['slug']; $info = json_decode( file_get_contents("https://itapi.top/openapi/info?slug=" . urlencode($slug)), true )['data']; echo "\n{$info['name']}（{$info['method']}）\n"; foreach ($info['params'] as $p) { echo " 参数 {$p['name']}（" . ($p['required'] ? '必填' : '可选') . "）：{$p['desc']}\n"; } /* 3. 拼参数调用 */ $qs = []; foreach ($info['params'] as $p) { if ($p['sample'] !== '') { $qs[$p['name']] = $p['sample']; } } $result = file_get_contents($info['url'] . '?' . http_build_query($qs)); echo "\n调用结果：\n{$result}"; 常见问题 问题 | 说明 浏览器里 fetch 报跨域？ | 接口已开启 CORS（Access-Control-Allow-Origin: *），一般不会；如有问题请反馈 为什么有的接口要密钥？ | 站长可对单个接口设置「需要密钥」，这类接口要在地址后加 &key=你的密钥，或用请求头 X-API-Key 返回 429 是什么意思？ | 请求太频繁，触发限流（60 次/分 · 1000 次/时） 支持 POST 吗？ | 支持。接口既接受 URL 参数也接受 POST 表单参数 接口返回 502 / 504？ | 该接口依赖的上游暂时不可用，稍后重试 导出文档 把本页内容导出成 Markdown 或 纯文本，方便存档、写进项目文档，或者直接交给 AI 助手当上下文用。 下载 Markdown（.md） 下载纯文本（.txt） 浏览器中预览 导出文件名：itapi-api-docs.md 或 itapi-api-docs.txt，内容会自动带上导出时间和来源地址。