Instagram
Instagram Works API
获取 Instagram 账号或频道的作品列表。
接口说明
Instagram Works API 获取 Instagram 账号或频道的作品列表。
使用 Pangolinfo API Key 调用,返回结构化 JSON 数据。
请求URL
请求头
| 参数名 | 参数值 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | application/json | string | 数据格式 |
| Authorization | Bearer xxx | string | 认证凭证 |
采集最长约75秒,客户端超时建议设为90秒。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| target | Yes | string | 主页链接; 也可直接传用户名 (可带 @) |
| options | No | object | 仅处理下列开放参数;未列出的字段忽略,内部参数不可覆盖。 |
options 参数说明
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| cursor | No | string | null | 续页: 上次输出的 pagination.cursor, 或 instagram-home 的 pagination.endCursor |
仅处理本页列出的请求参数,其他字段忽略。分页游标原样传回,不编码、解码或转换格式。
每次只取一页,用返回游标续取。
响应值
| 返回值 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码,0 表示成功 |
| message | string | 响应信息,成功时为 ok |
| pointCost | number | 本次请求实际消耗的积点 |
| data | object | 返回数据,结构见下表 |
| meta | object | 请求标识及耗时(毫秒) |
| billing | object | 计费条数、单价及规则版本 |
返回参数 data 说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| type | string | Type 可用值: [“works”] |
| pagination | object | 作品分页 |
| works | object[] | 作品列表 |
data.pagination 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| cursor | string | null | 下一页游标, 传回 options.cursor 续取; null + hasMore 表示首屏被截断, 从头取 |
| hasMore | boolean | 是否还有更多 |
data.works[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| url | string | null | 帖子链接 |
| type | string | 作品类型 可用值: [“video”, “image”] |
| cover | string | null | 封面 |
| copywriting | string | null | 正文 |
| likes | number | null | 点赞数; 匿名首屏 / 翻页不给, 为 null |
| comments | number | null | 评论数; 匿名首屏 / 翻页不给, 为 null |
| is_pinned | boolean | 是否置顶 |
| published_at | number | null | 发布时间毫秒时间戳; 匿名常为 null |
| video_view_count | number | null | 播放数; 匿名常为 null |
| mediaId | string | null | 媒体 id |
| pk | string | null | 帖子数字 id |
| shortcode | string | null | 帖子 shortcode |
| dimensions | object | 尺寸; 匿名接口通常为空对象 |
| isVideo | boolean | 是否视频 |
| mediaType | number | null | 1 图片 / 2 视频 / 8 轮播 |
| carouselMediaCount | number | null | 轮播张数; 非轮播为 null |
| videoUrl | string | null | 视频地址; 匿名常为 null |
| displayUrl | string | null | 展示图 |
| accessibilityCaption | string | null | 无障碍描述 |
| productType | string | null | 产品类型: feed / clips / carousel_container |
| location | any | 地点 (上游原样); 没有为 null |
| commentsDisabled | boolean | null | 是否关闭评论 |
data.works[].dimensions 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| width | number | Width |
| height | number | Height |
请求示例
返回示例
下例截取实际响应中的首条列表记录,长文本与链接作了缩写;pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。
积点消耗说明
每条主体结果消耗 0.8 积点。
空结果、失败响应不扣费。同一响应中相同 ID 只计一次,独立调用和续页分别计费。详见 社媒评论 API 计费说明。

