Instagram Reels 列表 API
使用返回的游标查询公开 Reels 列表和可用互动数据。
使用返回的游标查询公开 Reels 列表和可用互动数据。
打开产品页与 API Tester接口与鉴权
POST https://api.goanyapi.com/api/v1/instagram/user/reels同步返回结果,无任务或轮询。使用 Authorization: Bearer YOUR_API_KEY;参数放在 JSON 请求体。没有 Path 或 Query 参数。
输入参数
每次固定请求 12 条,实际返回可能更少。不接受 first、count 或 page_size 参数。首次不传 cursor,下一页使用 data.result.next_cursor。
| 参数 | 位置 | 类型 | 必填 | 默认值 | 范围与说明 |
|---|---|---|---|---|---|
| Authorization | Header | string | 是 | — | Bearer YOUR_API_KEY |
| Content-Type | Header | string | 是 | application/json | application/json |
| username | JSON body | string | 是 | — | 用户名、@用户名或平台完整主页链接;Instagram 主页还支持 /reels/、/tagged/ 后缀。 maxLength=2048 |
| cursor | JSON body | string | 否 | — | 首次不传;后续使用返回的 next_cursor 或 nextCursor,不猜测偏移。 maxLength=8192 |
资源输入接受原始标识或相应的完整 URL,使用同一个参数,不需要前置获取 ID。URL 解析不增加请求或独立扣费;不支持短链和其他资源类型。
用户名、@用户名或平台完整主页链接;Instagram 主页还支持 /reels/、/tagged/ 后缀。
请求示例
POST /api/v1/instagram/user/reels
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"username": "https://www.instagram.com/peggyzou89/reels/"
}输出字段
成功返回 HTTP 200。业务结果位于 data.result。null、空字符串、空数组和缺失字段按实际数据保留,零值是有效统计。不会因某个展示字段为空而使整次请求失败。
| 字段 | 类型 | 说明 |
|---|---|---|
| code | string | 成功为 ok;错误为对应错误码 |
| message | string | 状态说明 |
| data.result | object / null | 实际业务数据,null 原样保留 |
| data.creditsUsed | integer | 本次扣除积分,来自当前配置 |
| data.remainingCredits | number | 结算后余额 |
| data.result.username | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.user_id | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.count | integer | 本次返回条数,不是全站记录总数 |
| data.result.posts | array | 当前响应的记录列表 |
| data.result.posts[].code | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].pk | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].url | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].taken_at | null (observed) | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].user | object | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].user.pk | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].user.id | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].like_count | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].comment_count | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].play_count | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].caption | null (observed) | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].has_audio | null (observed) | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].size | array | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].video_urls | array | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.posts[].cover | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.next_cursor | string | 下一页游标,传入 cursor;为空时不要猜测偏移 |
| data.result.has_more | boolean | 是否报告还有更多结果;还需有效且不同的下一页游标 |
首次请求不传 cursor。后续保持其他条件不变,仅使用响应中返回的下一页游标;每页独立请求与计费。data.result.has_more 为 false、游标为空或与当前游标相同时停止。返回条数不一定等于请求条数,不推断总数。
真实响应示例
以下保存自真实成功响应,仅展示公开业务字段。示例省略实时 data.creditsUsed 和 data.remainingCredits;实际请求返回当前配置费用和账户余额。没有删减列表记录。媒体链接可能过期。打开示例不会查询或扣费。
{
"code": "ok",
"message": "ok",
"data": {
"result": {
"username": "peggyzou89",
"user_id": "17841445318616624",
"count": 12,
"posts": [
{
"code": "DcuF5s7BIUh",
"pk": "3976141476492248353",
"url": "https://www.instagram.com/reel/DcuF5s7BIUh/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 19495,
"comment_count": 112,
"play_count": 1174904,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/786213235_28582403764699464_7324963403489356884_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=jg_qTtomW0MQ7kNvwHhqneV&_nc_oc=AdprUvjo07vlRlOx2ip-KvWLFwqf2NOotTh6HUu2tf4AVPxshlgrNOIXFP3WTQZ_QOQ&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQQcZ2-IXCqD9bro7B6F9CDNqa3mnmQZpyokwAFdT4WEug&oe=6B00AF1E"
},
{
"code": "DfxxIRDBnNJ",
"pk": "4031219213812527945",
"url": "https://www.instagram.com/reel/DfxxIRDBnNJ/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 852,
"comment_count": 10,
"play_count": 120660,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.82787-15/897383659_18088617635510621_621705795789675145_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=11YpdP_7hC0Q7kNvwFddSuZ&_nc_oc=AdoWXALVjq6e5rNw2fw1iVN8CQdgbkEYwOgySA_OMAQkOOi9X3tGQMVirGZf3t1ma_g&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQ4AAAA&oh=00_AQRZikK726u1Uj7MHtnIpVdQ-Lnp8D0KMkemBJKRHwRmpQ&oe=6B00C029"
},
{
"code": "DfvP0lahOUV",
"pk": "4030509775803704597",
"url": "https://www.instagram.com/reel/DfvP0lahOUV/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 293,
"comment_count": 18,
"play_count": 2320,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/898421037_2157377892320731_2939594704562919903_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=-tYmJ5VUrw4Q7kNvwHpJCN_&_nc_oc=AdoP03YWKdkNkNXp3qnYxxZNNQJldQtFN9q4f7njmzyMZFmEwLF0KB-j0TwQ-Ys3OWI&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQQ55D74bH1hVMw7hokmrCQ3oLg1C0PwiztdhTUbPsIVhA&oe=6B00BEF5"
},
{
"code": "DfsidWKhMjY",
"pk": "4029747316834748632",
"url": "https://www.instagram.com/reel/DfsidWKhMjY/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 70,
"comment_count": 4,
"play_count": 3106,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.82787-15/896424510_18088616315510621_4250341777225889654_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=iTEo2AGtvNMQ7kNvwHe750q&_nc_oc=Ado8RgJ1qqdjZ_vnHFI6N1IOCxoyCCeTkearnDsdgJlz0PQv35qnJ7_d4_9nIdybX80&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQ4AAAA&oh=00_AQSDG3E_3vZ7gV5ejpssISPcuNy8HMWZ9UUh97Vg41i20w&oe=6B00BA6B"
},
{
"code": "DfqD-nzBJTp",
"pk": "4029050314115290345",
"url": "https://www.instagram.com/reel/DfqD-nzBJTp/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 79,
"comment_count": 3,
"play_count": 1745,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-1.cdninstagram.com/v/t51.82787-15/890616641_18088615757510621_7412439345795181090_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=xueV9y1RW9kQ7kNvwFyr2j2&_nc_oc=Ado_NBwnu82q72A9ef7pxBtn6v9HmG4IwwavnEm6hz-r8e769fpPrg_4IkH5b_SHtCQ&_nc_zt=23&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQ4AAAA&oh=00_AQQnrUA9pTnEuZHXCvkWLeo3QcNPgN58HGe0WZEkN0zlyw&oe=6B00ABDA"
},
{
"code": "Dfk7hWAhJxG",
"pk": "4027605742893964358",
"url": "https://www.instagram.com/reel/Dfk7hWAhJxG/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 55,
"comment_count": 1,
"play_count": 1770,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.82787-15/856534748_18085155428510621_5955364233745298862_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=tDhitYUJFo4Q7kNvwFY1ybg&_nc_oc=AdrJ5R7Z0gTNzzscrDru5X4zyBVHxgkM4kkLt9TZWuq-ZfW5z9v-ES6BytkGs4d-HXI&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQQJS0B4zqVF9xy7R2Oy-LcVloyYA64ev7HQ5Smh3ZeLEg&oe=6B00B0E2"
},
{
"code": "DfiY8uTh-cY",
"pk": "4026890742827312920",
"url": "https://www.instagram.com/reel/DfiY8uTh-cY/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 34,
"comment_count": 4,
"play_count": 1070,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/860152996_1411862054387709_899624121882638327_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=C-PzqB0Cl54Q7kNvwH2Qao-&_nc_oc=AdqNFzf_eVmcLuyp-gUUQ9UtJDVMKhIXm5V-ShNWXEJJBU0bPMaLb9z2GgIO3C-8K2w&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQSxSPpwz5PeU5YG5S1UDrCpJT6v1YH-X0pfEwFpU3rLkg&oe=6B00D4C7"
},
{
"code": "DffsJciB-Fx",
"pk": "4026130755050004849",
"url": "https://www.instagram.com/reel/DffsJciB-Fx/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 33,
"comment_count": 1,
"play_count": 1368,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-1.cdninstagram.com/v/t51.82787-15/857367833_18085153877510621_3963890185175751170_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=v7btWITJy-8Q7kNvwEFRhSB&_nc_oc=AdqSvarjFyxtJvTpoQJ_SNJRXjJxlcKtQXQ69pwUjoUiFU0pjVtck8vPB3Unr78HXSw&_nc_zt=23&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQSNPI_TwEbYE2dyIm785gLnmkIWdDE9ramCn_23QJAo0w&oe=6B00C9C9"
},
{
"code": "DfdKQBOhlVV",
"pk": "4025418723233256789",
"url": "https://www.instagram.com/reel/DfdKQBOhlVV/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 149,
"comment_count": 3,
"play_count": 3534,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/861834081_1470004301675686_7255715688488543766_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=mnR_JcWcReIQ7kNvwEhvKwq&_nc_oc=Adr7T2Fr43Qby7RKM8aItmRQEoPw2xFnDAoL1H9jqMMZmDMOk3iOXGPz6wn6K7E04Z4&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQQnqtBO-2s6dus-OW4FelAjoPqgmv5rnlwlJsm_CeTQ6A&oe=6B00D0FE"
},
{
"code": "DfX-XZQhYHR",
"pk": "4023959078631211473",
"url": "https://www.instagram.com/reel/DfX-XZQhYHR/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 65,
"comment_count": 2,
"play_count": 1428,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.71878-15/862620142_2182448292369481_1499216731697373159_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=ycEoNyTevSUQ7kNvwH66p4X&_nc_oc=Adp8ti70WiXc4sViFW0s8KrAe89aX6NY2nroC4Hw_2pUVmPCbT-zVAX8pyaE6ZN_6IU&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQRzm5V4N-WOM43fHsPopy1jmTvX04TMCtucs-qpruOhww&oe=6B00BA30"
},
{
"code": "DfVnWAjBttz",
"pk": "4023294878355479411",
"url": "https://www.instagram.com/reel/DfVnWAjBttz/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 100,
"comment_count": 6,
"play_count": 2115,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.71878-15/863871666_963233599715665_2136836762004690690_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=X6B_wotD-uwQ7kNvwH2mgtu&_nc_oc=Adp7CVK8WW-BDhJIjZP3HgjMqPOriDIbkev464c_gRYB8GqYjsP1cnNGa7h5BsXliug&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQRpmI7xqhLZdNFLW3zeCBsrqQHVWQe3AumN1QnbfBL0eg&oe=6B00AF23"
},
{
"code": "DfS7pqQhi0a",
"pk": "4022539764812360986",
"url": "https://www.instagram.com/reel/DfS7pqQhi0a/",
"taken_at": null,
"user": {
"pk": "45252998620",
"id": "17841445318616624"
},
"like_count": 36,
"comment_count": 3,
"play_count": 1444,
"caption": null,
"has_audio": null,
"size": [
null,
null
],
"video_urls": [],
"cover": "https://scontent-lga3-1.cdninstagram.com/v/t51.82787-15/863609232_18085154288510621_6627764684697588653_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=MVZVvfoAiogQ7kNvwG2D8vL&_nc_oc=AdozBc5Q-_6A8t2xFgAuwEJ19oLb98tJ-FTnkqMBUkSKDwSHfDJ7IJG_laxFYEL7qwc&_nc_zt=23&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQRgmtlTBzzF30p7E9MUCzV5WMDO_dW405eJiadGCAv13A&oe=6B00A79A"
}
],
"next_cursor": "AQHTS2nGUt-7QXO1WoYiMcmQrPUyo7z4QKqYTdD3FjscM4jwQn30j1xrGhzFrppL3SCZVHMLZPrZtXagXZyP5fl_Iw",
"has_more": true
}
}
}计费
当前配置下,每次成功请求消耗 1 积分。
每次成功请求包含空结果,均按当前数据库配置结算;失败不扣费。查询前必须有足够余额,并发结算时余额不足返回 402,不交付未结算结果。URL 解析不单独收费。
状态码与错误
| HTTP | 含义 |
|---|---|
| 200 | 成功(含空结果) |
| 400 | JSON 或参数无效 |
| 401 | 鉴权无效 |
| 402 | 积分不足 |
| 429 | 请求过于频繁,按 Retry-After 等待 |
| 502 | 数据请求失败 |
| 503 | 接口或价格未配置 |
{"code":"invalid_params","message":"Invalid parameter"}