{
"openapi": "3.0.3",
"info": {
"title": "insjiexi · Instagram Media Parser API",
"version": "1.0.0",
"description": "Instagram 媒体解析接口。支持 Post / Reel / Reels / IGTV / 轮播多图。返回直链可用于图片预览、视频播放、下载。\n\n**主要能力**:\n- 输入任意 IG 链接，返回作者、标题、点赞/评论/播放数、媒体直链（含多分辨率、缩略图、时长）。\n- 内置代理下载接口，规避 IG CDN 的 Referer / CORS 限制。\n- 多账号 sessionid cookie 轮询，单账号被风控时自动切换。\n\n**部署**: 香港机房直连 Instagram，无需翻墙。",
"contact": {
"name": "insjiexi",
"url": "https://ins.baziapi.site"
},
"license": { "name": "MIT" }
},
"servers": [
{ "url": "https://ins.baziapi.site", "description": "生产环境" }
],
"tags": [
{ "name": "Parse", "description": "解析 Instagram 链接，提取媒体直链" },
{ "name": "Download", "description": "服务器代理下载远端媒体（绕开 Referer / CORS 限制）" },
{ "name": "Health", "description": "健康检查" },
{ "name": "Admin", "description": "Cookie 池管理（需要 ADMIN_TOKEN）" }
],
"paths": {
"/healthz": {
"get": {
"tags": ["Health"],
"summary": "健康检查",
"description": "返回当前服务存活状态。",
"responses": {
"200": {
"description": "ok",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"ok": { "type": "boolean", "example": true },
"ts": { "type": "integer", "format": "int64", "example": 1778760565023 }
}
}
}
}
}
}
}
},
"/ins/parse": {
"get": {
"tags": ["Parse"],
"summary": "解析 IG 链接（GET）",
"description": "传入任意 Instagram 链接（Post / Reel / Reels / IGTV），返回标准化的媒体信息。\n\n支持的 URL 格式:\n- `https://www.instagram.com/p/{shortcode}/`\n- `https://www.instagram.com/reel/{shortcode}/`\n- `https://www.instagram.com/reels/{shortcode}/`\n- `https://www.instagram.com/tv/{shortcode}/`",
"parameters": [
{
"name": "url",
"in": "query",
"description": "Instagram 完整链接。`url` 和 `url_b64` 二选一。",
"required": false,
"schema": { "type": "string" },
"example": "https://www.instagram.com/reels/DXkcccJud-w/"
},
{
"name": "url_b64",
"in": "query",
"description": "Instagram 链接的 base64 编码版（用于规避中间链路对 `instagram.com` 关键字的嗅探。HTTPS 接入后通常不需要）。",
"required": false,
"schema": { "type": "string" },
"example": "aHR0cHM6Ly93d3cuaW5zdGFncmFtLmNvbS9yZWVscy9EWGtjY2NKdWQtdy8="
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ParseResponse" },
"examples": {
"video": { "$ref": "#/components/examples/VideoExample" }
}
}
}
},
"400": {
"description": "参数错误",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ErrorResponse" }
}
}
},
"500": {
"description": "解析失败（所有策略都失败时返回，含每个策略的失败原因）",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ErrorResponse" }
}
}
}
}
},
"post": {
"tags": ["Parse"],
"summary": "解析 IG 链接（POST）",
"description": "等价于 GET /ins/parse，但参数通过 JSON body 提交。",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"url": { "type": "string", "example": "https://www.instagram.com/reels/DXkcccJud-w/" },
"url_b64": { "type": "string", "description": "可选，url 的 base64 版本" }
}
}
}
}
},
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": { "schema": { "$ref": "#/components/schemas/ParseResponse" } }
}
},
"400": { "description": "参数错误", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } },
"500": { "description": "解析失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }
}
}
},
"/ins/download": {
"get": {
"tags": ["Download"],
"summary": "代理下载远端媒体",
"description": "把 IG CDN 上的视频 / 图片 / 头像通过本服务流式转发回客户端。\n\n用途:\n- 前端 `![]()
` `