API 文档

Instagram 帖子详情 API

查询公开 Instagram 帖子或 Reels 的媒体、作者与互动数据。

测试 API

查询公开 Instagram 帖子或 Reels 的媒体、作者与互动数据。

打开产品页与 API Tester

接口与鉴权

POST https://api.goanyapi.com/api/v1/instagram/post/detail

同步返回结果,无任务或轮询。使用 Authorization: Bearer YOUR_API_KEY;参数放在 JSON 请求体。没有 Path 或 Query 参数。

输入参数

参数位置类型必填默认值范围与说明
AuthorizationHeaderstring是—Bearer YOUR_API_KEY
Content-TypeHeaderstring是application/jsonapplication/json
codeJSON bodystring是—帖子 shortcode 或 instagram.com 的 /p/、/reel/、/reels/ 完整链接。 maxLength=2048

资源输入接受原始标识或相应的完整 URL,使用同一个参数,不需要前置获取 ID。URL 解析不增加请求或独立扣费;不支持短链和其他资源类型。

帖子 shortcode 或 instagram.com 的 /p/、/reel/、/reels/ 完整链接。

请求示例

POST /api/v1/instagram/post/detail
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "code": "https://www.instagram.com/reel/DfMyWK-hQFW/"
}

输出字段

成功返回 HTTP 200。业务结果位于 data.result。null、空字符串、空数组和缺失字段按实际数据保留,零值是有效统计。不会因某个展示字段为空而使整次请求失败。

字段类型说明
codestring成功为 ok;错误为对应错误码
messagestring状态说明
data.resultobject / null实际业务数据,null 原样保留
data.creditsUsedinteger本次扣除积分,来自当前配置
data.remainingCreditsnumber结算后余额
data.result.original_widthinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.video_dash_manifest_leninteger公开业务字段;按实际结果返回,可为空或缺失
data.result.codestring公开业务字段;按实际结果返回,可为空或缺失
data.result.taken_atinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.like_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.clips_metadataobject公开业务字段;按实际结果返回,可为空或缺失
data.result.clips_metadata.music_infonull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.clips_metadata.original_sound_infoobject公开业务字段;按实际结果返回,可为空或缺失
data.result.clips_metadata.original_sound_info.consumption_infoobject公开业务字段;按实际结果返回,可为空或缺失
data.result.clips_metadata.original_sound_info.consumption_info.should_mute_audio_reason_typenull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.has_audioboolean公开业务字段;按实际结果返回,可为空或缺失
data.result.idstring公开业务字段;按实际结果返回,可为空或缺失
data.result.captionstring公开业务字段;按实际结果返回,可为空或缺失
data.result.comment_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.original_heightinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.pkstring公开业务字段;按实际结果返回,可为空或缺失
data.result.video_versionsarray公开业务字段;按实际结果返回,可为空或缺失
data.result.video_versions[].urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.video_versions[].heightnull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.video_versions[].typeinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.video_versions[].mimeTypenull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.video_versions[].widthnull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.number_of_qualitiesinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.is_dash_eligibleinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.image_versions2_candidatesarray公开业务字段;按实际结果返回,可为空或缺失
data.result.image_versions2_candidates[].heightnull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.image_versions2_candidates[].widthnull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.image_versions2_candidates[].urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.userobject公开业务字段;按实际结果返回,可为空或缺失
data.result.user.usernamestring公开业务字段;按实际结果返回,可为空或缺失
data.result.user.profile_pic_urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.user.pkstring公开业务字段;按实际结果返回,可为空或缺失

此接口无分页参数。

真实响应示例

以下保存自真实成功响应,仅展示公开业务字段。示例省略实时 data.creditsUsed 和 data.remainingCredits;实际请求返回当前配置费用和账户余额。没有删减列表记录。媒体链接可能过期。打开示例不会查询或扣费。

{
  "code": "ok",
  "message": "ok",
  "data": {
    "result": {
      "pk": "4020809993275375958",
      "id": "POLARIS_4020809993275375958",
      "code": "DfMyWK-hQFW",
      "taken_at": 1793538007,
      "original_width": 1080,
      "original_height": 1920,
      "user": {
        "pk": "61117905602",
        "username": "realchinesewithluella",
        "profile_pic_url": "https://scontent-sjc3-1.cdninstagram.com/v/t51.82787-19/777916394_17988995619033603_2664203103875575616_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ig_cache_key=GOoPXi4DEr1t5eg-AEAv-3_bJvkkbmNDAQAB1501500j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=oGRs_-y3zEcQ7kNvwHhRLAN&_nc_oc=AdqOQfpKcweh99yG3MPGDhSmbL36b2408kjJARFlD0kCWFLkAe-QWjX4-ZqI9s15bmg&_nc_zt=24&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_ct=RQosPBUCFQIAAAA&oh=00_AQSpwQKZNG2KAsh3G64t5VUIxXBSVcaXq6OFtBG1dzdP9w&oe=6B004254"
      },
      "like_count": 10923,
      "comment_count": 30,
      "has_audio": true,
      "is_dash_eligible": 1,
      "number_of_qualities": 4,
      "caption": "#chinese #chineselanguage #chineselearning #mandarin #funny",
      "clips_metadata": {
        "music_info": null,
        "original_sound_info": {
          "consumption_info": {
            "should_mute_audio_reason_type": null
          }
        }
      },
      "video_versions": [
        {
          "type": 101,
          "width": null,
          "height": null,
          "mimeType": null,
          "url": "https://scontent-sjc3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPj6Ix0c5tmDjveAaM-j4V2-cvdBm_8Z0t6wQ5Sgb5DhgxSpuEuNmwaArDxtWdvSc4_LSfMOk0L3scXJLl0gDPzRjTtPSC-lF_W96w.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_ohc=i_5hnFwSeJ4Q7kNvwG9ngBX&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjIxMDAwMDc5OTk0Mzc4MCwiYXNzZXRfYWdlX2RheXMiOjE0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTIsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=d14f9f4ce41bc51b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzFBMEI1Q0QxMUE0MDc3OThCODg0RjY2QzdBREQ0Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0NEMTExM0VDM0VDNDQ0QTg4MzhDMzFBRjM3RUU5OTIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwOIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRJjb3B5X3NhbXBsZV9ncm91cHMBMRUAACbIsZKK_f7sBxUCKAJDMywXQCi7ZFocrAgYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQSETog8oEJPW6s3Pv-c0gOs1we_W2GvqpPIeAJoBIGp5Q&oe=6AFC515C"
        },
        {
          "type": 102,
          "width": null,
          "height": null,
          "mimeType": null,
          "url": "https://scontent-sjc3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPj6Ix0c5tmDjveAaM-j4V2-cvdBm_8Z0t6wQ5Sgb5DhgxSpuEuNmwaArDxtWdvSc4_LSfMOk0L3scXJLl0gDPzRjTtPSC-lF_W96w.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_ohc=i_5hnFwSeJ4Q7kNvwG9ngBX&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjIxMDAwMDc5OTk0Mzc4MCwiYXNzZXRfYWdlX2RheXMiOjE0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTIsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=d14f9f4ce41bc51b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzFBMEI1Q0QxMUE0MDc3OThCODg0RjY2QzdBREQ0Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0NEMTExM0VDM0VDNDQ0QTg4MzhDMzFBRjM3RUU5OTIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwOIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRJjb3B5X3NhbXBsZV9ncm91cHMBMRUAACbIsZKK_f7sBxUCKAJDMywXQCi7ZFocrAgYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQSETog8oEJPW6s3Pv-c0gOs1we_W2GvqpPIeAJoBIGp5Q&oe=6AFC515C"
        },
        {
          "type": 103,
          "width": null,
          "height": null,
          "mimeType": null,
          "url": "https://scontent-sjc3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPj6Ix0c5tmDjveAaM-j4V2-cvdBm_8Z0t6wQ5Sgb5DhgxSpuEuNmwaArDxtWdvSc4_LSfMOk0L3scXJLl0gDPzRjTtPSC-lF_W96w.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_ohc=i_5hnFwSeJ4Q7kNvwG9ngBX&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjIxMDAwMDc5OTk0Mzc4MCwiYXNzZXRfYWdlX2RheXMiOjE0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTIsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=d14f9f4ce41bc51b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzFBMEI1Q0QxMUE0MDc3OThCODg0RjY2QzdBREQ0Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0NEMTExM0VDM0VDNDQ0QTg4MzhDMzFBRjM3RUU5OTIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwOIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRJjb3B5X3NhbXBsZV9ncm91cHMBMRUAACbIsZKK_f7sBxUCKAJDMywXQCi7ZFocrAgYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQSETog8oEJPW6s3Pv-c0gOs1we_W2GvqpPIeAJoBIGp5Q&oe=6AFC515C"
        }
      ],
      "image_versions2_candidates": [
        {
          "width": null,
          "height": null,
          "url": "https://scontent-sjc6-1.cdninstagram.com/v/t51.71878-15/852558649_1459559266272163_6328943251903360248_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ig_cache_key=NDAyMDgwOTk5MzI3NTM3NTk1OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjY0MC5zZHIudmlkZW9fZmlyc3RfZnJhbWVfdGh1bWJuYWlsLkMzIn0%3D&_nc_ohc=VQuJdGcbgpYQ7kNvwGvKfB_&_nc_oc=AdriaMpRMbLsub_SgE_VD3ZRrXVkQajAxTlJ2Vc5pyo7CyVg-4wfXoD1NLlljcDaQyo&_nc_zt=23&_nc_ht=scontent-sjc6-1.cdninstagram.com&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_ct=RQosPBUIFQolBAAAAA&oh=00_AQQTAv4Zm8l0tTLn_I66Er3zqmf5Ra_0FjACiC9gLdkXdQ&oe=6B0041C6"
        },
        {
          "width": null,
          "height": null,
          "url": "https://scontent-sjc6-1.cdninstagram.com/v/t51.71878-15/852558649_1459559266272163_6328943251903360248_n.jpg?stp=dst-jpg_e15_p480x480_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ig_cache_key=NDAyMDgwOTk5MzI3NTM3NTk1OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjY0MC5zZHIudmlkZW9fZmlyc3RfZnJhbWVfdGh1bWJuYWlsLkMzIn0%3D&_nc_ohc=VQuJdGcbgpYQ7kNvwGvKfB_&_nc_oc=AdriaMpRMbLsub_SgE_VD3ZRrXVkQajAxTlJ2Vc5pyo7CyVg-4wfXoD1NLlljcDaQyo&_nc_zt=23&_nc_ht=scontent-sjc6-1.cdninstagram.com&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_ct=RQosPBUIFQolBAAAAA&oh=00_AQTCDoClPZmAOMlXtx9M8OCIH4_ZGt4bAg2bxbo0B4gORA&oe=6B0041C6"
        }
      ],
      "video_dash_manifest_len": 9393
    }
  }
}

计费

当前配置下,每次成功请求消耗 1 积分。

每次成功请求包含空结果,均按当前数据库配置结算;失败不扣费。查询前必须有足够余额,并发结算时余额不足返回 402,不交付未结算结果。URL 解析不单独收费。

状态码与错误

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