API 文档

Instagram Reels 列表 API

使用返回的游标查询公开 Reels 列表和可用互动数据。

测试 API

使用返回的游标查询公开 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。

参数位置类型必填默认值范围与说明
AuthorizationHeaderstring是—Bearer YOUR_API_KEY
Content-TypeHeaderstring是application/jsonapplication/json
usernameJSON bodystring是—用户名、@用户名或平台完整主页链接;Instagram 主页还支持 /reels/、/tagged/ 后缀。 maxLength=2048
cursorJSON bodystring否—首次不传;后续使用返回的 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、空字符串、空数组和缺失字段按实际数据保留,零值是有效统计。不会因某个展示字段为空而使整次请求失败。

字段类型说明
codestring成功为 ok;错误为对应错误码
messagestring状态说明
data.resultobject / null实际业务数据,null 原样保留
data.creditsUsedinteger本次扣除积分,来自当前配置
data.remainingCreditsnumber结算后余额
data.result.usernamestring公开业务字段;按实际结果返回,可为空或缺失
data.result.user_idstring公开业务字段;按实际结果返回,可为空或缺失
data.result.countinteger本次返回条数,不是全站记录总数
data.result.postsarray当前响应的记录列表
data.result.posts[].codestring公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].pkstring公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].taken_atnull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].userobject公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].user.pkstring公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].user.idstring公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].like_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].comment_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].play_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].captionnull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].has_audionull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].sizearray公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].video_urlsarray公开业务字段;按实际结果返回,可为空或缺失
data.result.posts[].coverstring公开业务字段;按实际结果返回,可为空或缺失
data.result.next_cursorstring下一页游标,传入 cursor;为空时不要猜测偏移
data.result.has_moreboolean是否报告还有更多结果;还需有效且不同的下一页游标

首次请求不传 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成功(含空结果)
400JSON 或参数无效
401鉴权无效
402积分不足
429请求过于频繁,按 Retry-After 等待
502数据请求失败
503接口或价格未配置
{"code":"invalid_params","message":"Invalid parameter"}