API 文档

Instagram 精选合集 API

查询公开精选合集的 ID、名称和封面,不包含合集内的 Story。

测试 API

查询公开精选合集的 ID、名称和封面,不包含合集内的 Story。

打开产品页与 API Tester

接口与鉴权

POST https://api.goanyapi.com/api/v1/instagram/user/highlights

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

输入参数

参数位置类型必填默认值范围与说明
AuthorizationHeaderstring是—Bearer YOUR_API_KEY
Content-TypeHeaderstring是application/jsonapplication/json
usernameJSON bodystring是—用户名、@用户名或平台完整主页链接;Instagram 主页还支持 /reels/、/tagged/ 后缀。 maxLength=2048

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

用户名、@用户名或平台完整主页链接;Instagram 主页还支持 /reels/、/tagged/ 后缀。

请求示例

POST /api/v1/instagram/user/highlights
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "username": "https://www.instagram.com/instagram/"
}

输出字段

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

字段类型说明
codestring成功为 ok;错误为对应错误码
messagestring状态说明
data.resultobject / null实际业务数据,null 原样保留
data.creditsUsedinteger本次扣除积分,来自当前配置
data.remainingCreditsnumber结算后余额
data.result.usernamestring公开业务字段;按实际结果返回,可为空或缺失
data.result.highlightsarray当前响应的记录列表
data.result.highlights[].idstring公开业务字段;按实际结果返回,可为空或缺失
data.result.highlights[].titlestring公开业务字段;按实际结果返回,可为空或缺失
data.result.highlights[].coverstring公开业务字段;按实际结果返回,可为空或缺失
data.result.countinteger本次返回条数,不是全站记录总数

此接口无分页参数。

真实响应示例

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

{
  "code": "ok",
  "message": "ok",
  "data": {
    "result": {
      "username": "instagram",
      "count": 7,
      "highlights": [
        {
          "id": "18142207969557132",
          "title": "creatives",
          "cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/756661521_3289512177887855_4009891805420027177_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=vxrwz-_XiHMQ7kNvwHNtU5P&_nc_oc=AdpCnaaIFbn_adTAcwAbPRBAQZ3akLLaO3WxaW-xKobRQDDfidcPICoHQh4IA9P54YE&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=xbeSfuS1PJ2fspWORs4Atw&_nc_ss=7fa8c&oh=00_AQRgG53CUGeGHag5RlRsydIHRWQuRIxk_5SnE56_KMYmEw&oe=6B0069D7"
        },
        {
          "id": "18032893448824228",
          "title": "🎾🏀⚽️",
          "cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.82787-15/575724433_18680673526001321_5945490939444494882_n.jpg?stp=c0.5x0.5f_dst-jpg_e35_p150x150_tt6_u&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiU1RPUlkuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=1Pjv167aEE8Q7kNvwH4r3P2&_nc_oc=Adro1bnvxbWdE6m3ZVV-1jZ6EnkHB_JDFa_1K4isOrlS0LOCaqXKjcKE0uIdNswf7iI&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=xbeSfuS1PJ2fspWORs4Atw&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQIAAAA&oh=00_AQRo-UheCT0uhfwdizDY-Oo54T0HoTv9VuYu54sBBqJT2Q&oe=6B007949"
        },
        {
          "id": "18612622252018257",
          "title": "🎤🎶🎸",
          "cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/755867844_1751720619182762_5430881549273743299_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=igSFmvc0wB0Q7kNvwEPkZtx&_nc_oc=AdoZq-T1R42VPfW5E4BXX5bmaHlpS8uyqVNEWOe_AMAKVcaAfwEpjS81rNjWdeMyE44&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=xbeSfuS1PJ2fspWORs4Atw&_nc_ss=7fa8c&oh=00_AQQf3ZspFkzmUGx2joUncmMYgpHfsjWfs0cLE1g-3PoB1Q&oe=6B006AAF"
        },
        {
          "id": "18029499352961095",
          "title": "what’s new",
          "cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/755331856_1609699020573638_4426177467586352650_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=T-MIH3VDRDAQ7kNvwFKPlfn&_nc_oc=AdpQi6nr9XyjLEPx50k60REXmw7dP6pE0dmabjd21u5i5h0wxu7PsjBy9CruAJoCm7g&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=xbeSfuS1PJ2fspWORs4Atw&_nc_ss=7fa8c&oh=00_AQS80fbNh9bIESZkjWCInedCrgaKhzLUEdP-Wx3GQyNLxg&oe=6B005EF3"
        },
        {
          "id": "18223279177302854",
          "title": "close friends",
          "cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/756700225_1653985762331725_8429300849500507026_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=l981QBSTlAgQ7kNvwHK4QeF&_nc_oc=AdqAYDlFD_t732xxWd8sOHjmWbkKXNmFIgkK6XoihhNAHQfx5k8_cVmH4qSKEepDmb0&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=xbeSfuS1PJ2fspWORs4Atw&_nc_ss=7fa8c&oh=00_AQTsX8OjbleTTqC1i701u7IzTuBsgfG29fvyTLBFUDvQDA&oe=6B00667E"
        },
        {
          "id": "18125969650775954",
          "title": "🚗🚗🚗",
          "cover": "https://scontent-lga3-1.cdninstagram.com/v/t51.71878-15/775233495_1033957092733525_6010470506239881158_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=acbce5&_nc_ohc=ItGmn4Ry2GkQ7kNvwFNt0PL&_nc_oc=AdpppLefUBSeHcvZ34jM3YIMmBPda8woEMlPeOajs4AfItNsWaidlB5ygZA53OUMH60&_nc_zt=23&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_gid=xbeSfuS1PJ2fspWORs4Atw&_nc_ss=7fa8c&oh=00_AQRX3pQBfrnqrX42Uz7bCdNg77EJQ1ScBfU7XWNob65hig&oe=6B0066B9"
        },
        {
          "id": "18194686561332120",
          "title": "🎥🌟🍿",
          "cover": "https://scontent-lga3-1.cdninstagram.com/v/t51.71878-15/755264526_1764587937905767_5811150211834945970_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=107&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=acbce5&_nc_ohc=NSpW5CwpckkQ7kNvwFRwG0K&_nc_oc=Adr6pafme4TxUKxuvExRoSQ8Q-u2jQIqC93bo1x5m9Hw0LTCd7FLp7kqtiIekKeXE54&_nc_zt=23&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_gid=xbeSfuS1PJ2fspWORs4Atw&_nc_ss=7fa8c&oh=00_AQRr0-iQGm7jCO_jkgSg1nrCaq7SN4UNDXixDkcInxEPmA&oe=6B007A39"
        }
      ]
    }
  }
}

计费

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

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

状态码与错误

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