您的团队需要 Instagram 帖子、短视频和帐户元数据,以便在本周以可交付的格式交付——计数、图像、尺寸和作者信息——而无需逆向工程 HTML 或 juggling 多个库。在本指南结束时,您将能够从 Zyla API Hub 调用 Instagram 数据 API,通过 URL 获取公共帖子数据,通过用户名获取帐户数据,通过短代码获取短视频指标,并将其连接到您的服务或 AI 代理。
您可以使用 Instagram 数据 API 构建的内容
Zyla 上的 Instagram 数据 API 返回公共 Instagram 资源的结构化信息,因此您可以将社交内容集成到您的产品中,而无需抓取。它支持:
- 通过 URL 获取帖子/出版物数据,包括媒体尺寸、显示 URL 和相关元数据。
- 通过用户名获取帐户数据,包括传记和个人资料链接。
- 通过短代码获取短视频数据,包括 like_count、comment_count 和 video_view_count。
典型用例包括社交证明小部件、分析仪表板、用户生成内容的审核和丰富,以及用于营销报告的内容摄取管道。
Zyla API Hub 是一个单一帐户、单一 API 密钥市场,采用订阅 + 配额模型(不是按调用付费),并且有超过 10,000 个公共 API 的目录,涵盖社交媒体和网络及其他类别。您可以在 zylalabs.com 浏览市场,并根据需要订阅单个 API。
在 Zyla API Hub 上开始
要集成,请打开 Instagram 数据 API 页面,单击订阅或开始免费试用(可用时),并复制您的 API 密钥。每个请求都使用 Authorization 头:Bearer YOUR_API_KEY。
从这里开始: 在 Instagram 数据 API 上开始 7 天试用。第一个 API 通常提供 7 天试用或 50 次请求。请查看 API 页面以获取当前访问选项和定价。
端点概述
1) 获取帖子数据
返回公共帖子 URL 的 Instagram 帖子/出版物数据。
- 方法:GET
- URL: https://zylalabs.com/api/855/instagram-data-api/630/get-post-data
- 所需查询参数:
- link (string):Instagram 帖子 URL。示例: https://www.instagram.com/p/BsOGulcndj-
cURL 示例:
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/630/get-post-data?link=https%3A%2F%2Fwww.instagram.com%2Fp%2FBsOGulcndj-"
-H "Authorization: Bearer YOUR_API_KEY"
示例响应(官方示例):
{
"status": true,
"__typename": "GraphImage",
"id": "1949525278281554174",
"shortcode": "BsOGulcndj-",
"dimensions": {
"height": 584,
"width": 584
},
"gating_info": null,
"fact_check_overall_rating": null,
"fact_check_information": null,
"sensitivity_friction_info": null,
"sharing_friction_info": {
"should_have_sharing_friction": false,
"bloks_app_url": null
},
"media_overlay_info": null,
"media_preview": null,
"display_url": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=instagram.fbcn2-1.fna.fbcdn.net&_nc_cat=105&_nc_oc=Q6cZ2gHBlHY2RHKNTgCNzMelAyz56Toi4DI7VUNsrK7XJAsoGT6ka4w7PVJ6IEqS7PD9Ulw&_nc_ohc=jwkKyc7eqGAQ7kNvwHmuCEW&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&edm=AOmX9WgBAAAA&ccb=7-5&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&oh=00_AQONRzWv-s9IPALJK9qeJ5FVyMcHbwpYaGsJhb7fdlV1nA&oe=6ACE9A40&_nc_sid=bfaa47",
"display_resources": [
{
"src": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e35_s360x360_sh2.08_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNTg0LnNkci5yZWd1bGFyX3Bob3RvLkMzIn0%3D&_nc_ohc=53XaOqCZWBYQ7kNvwFfkQTV&_nc_oc=AdprbrBLkElSfmNNOrQHEYQuCIz8F8lIlYN7TENXKNGCcZVnybmvx0uXH6fzElyfwak&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fbcn2-1.fna&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&_nc_ss=7a3ba&oh=00_AQNBRrpvxf3JGSktIaicSqaD4UtCuDo9I8feI6acpRs9Eg&oe=6ACE9A40",
"config_width": 360,
"config_height": 360
},
{
"src": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNTg0LnNkci5yZWd1bGFyX3Bob3RvLkMzIn0%3D&_nc_ohc=53XaOqCZWBYQ7kNvwFfkQTV&_nc_oc=AdprbrBLkElSfmNNOrQHEYQuCIz8F8lIlYN7TENXKNGCcZVnybmvx0uXH6fzElyfwak&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fbcn2-1.fna&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&_nc_ss=7a3ba&oh=00_AQMhFQizLfIe4bAcskLHhT2nCDcjFGyldOq2Cp7IMLuVxg&oe=6ACE9A40",
"config_width": 584,
"config_height": 584
}
],
"accessibility_caption…
您通常会使用的关键字段:
- id 和 shortcode:用于去重和链接的稳定标识符。
- dimensions:媒体的高度和宽度。
- display_url 和 display_resources:不同尺寸的媒体资产的 URL。
- __typename:媒体类型提示(例如,GraphImage)。
2) 获取帐户数据
通过用户名返回公共 Instagram 帐户数据。
- 方法:GET
- URL: https://zylalabs.com/api/855/instagram-data-api/631/get-account-data
- 所需查询参数:
- username (string):Instagram 用户名。示例: leomessi
cURL 示例:
响应返回指定用户名的帐户元数据,例如传记和 bio_links。
3) 获取短视频数据
通过短代码返回公共 Instagram 短视频/帖子指标。包括点赞、评论和观看次数的计数。
- 方法:GET
- URL: https://zylalabs.com/api/855/instagram-data-api/32007/get-reel-data
- 所需查询参数:
- shortcode (string):帖子/短视频的 Instagram 短代码。示例: DctYV2qt6S5
cURL 示例:
示例响应(官方示例):
您通常会使用的关键字段:
- like_count 和 comment_count:仪表板和警报的参与指标。
- video_view_count(和 play_count):短视频性能跟踪。
- code:请求的短代码的回显,以便进行关联。
Python 中的端到端示例
下面的代码段通过短代码获取短视频指标并打印参与 KPI。它使用与上面的 cURL 示例中显示的相同的端点和参数。
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
SHORTCODE = "DctYV2qt6S5"
url = "https://zylalabs.com/api/855/instagram-data-api/32007/get-reel-data"
params = {"shortcode": SHORTCODE}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
data = resp.json()
# 提取您的应用程序可能需要的字段
like_count = data.get("like_count")
comment_count = data.get("comment_count")
views = data.get("video_view_count")
print({
"shortcode": data.get("code"),
"likes": like_count,
"comments": comment_count,
"views": views
})
您可以期待的 JSON(如上所示):
节省时间的实施说明
- Authorization 头:始终包括 Authorization: Bearer YOUR_API_KEY。不要在查询参数中发送密钥。
- URL 编码:对于获取帖子数据,link 参数必须进行 URL 编码。提供的 cURL 显示了正确的形式。
- 仅公共数据:这些端点返回公共 Instagram 资源的信息。
- 缓存:短视频的参与数字可能会迅速变化。如果您正在轮询,请短暂缓存响应(例如,30-120 秒),以避免冗余调用,同时保持仪表板的更新。
- 错误处理:处理非 200 和 JSON 解析错误。如果您批量更新,指数退避会有所帮助。
- 配额:Zyla API 使用订阅 + 配额。第一个 API 通常包括 7 天试用或 50 次请求;在进行大规模回填之前,请检查列表以获取当前限制。
现实世界的用例
- 嵌入带有验证元数据的帖子:解析帖子 URL 以获取尺寸和 display_url,存储短代码,并使用一致的 UI 渲染。
- 创作者和品牌页面:使用获取帐户数据在活动或产品页面旁边显示帐户的传记和外部链接。
- 短视频性能跟踪:每分钟轮询获取短视频数据的高优先级短代码,并将增量(点赞、评论、video_view_count)推送到您的指标存储。
- 对用户生成内容的自动 QA:验证提交的 Instagram URL 实际上解析为图像或短视频,并通过尺寸满足您的大小要求。
从 AI 代理调用 API(MCP)
您可以通过 MCP 端点 https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY 从与 MCP 兼容的客户端调用 Zyla API。这对于使用 AI 编码工具进行原型设计或将检查连接到 AI 运行手册非常有用。有关详细信息,请参见 MCP。
可复制的请求集合
使用这些确切的请求,并将您的密钥放入 Authorization 头中。
获取帖子数据(通过 URL)
获取帐户数据(通过用户名)
获取短视频数据(通过短代码)
操作检查清单
- 环境中的密钥:将 YOUR_API_KEY 存储在您的秘密管理器或环境变量中。
- 监控:跟踪非 200 和超时;重试瞬态故障。
- 数据模型:持久化帖子/短视频的短代码,以避免重复并启用有针对性的刷新。
- 变化速率:短视频频繁更新;为优先项目安排更紧的轮询窗口,为其余项目安排更长的窗口。
- 市场管理:使用您的 Zyla 仪表板监控配额使用情况。当扩展功能时,您可以随时在 zylalabs.com 探索其他社交媒体和网络 API。
常见问题解答
问:我如何验证请求?
答:在每个请求中包含头 Authorization: Bearer YOUR_API_KEY。
问:我应该向获取帖子数据传递什么输入?
答:通过 link 参数提供 URL 编码的 Instagram 帖子 URL,例如 link=https%3A%2F%2Fwww.instagram.com%2Fp%2FBsOGulcndj-。
问:我应该向获取短视频数据传递什么输入?
答:使用 shortcode 查询参数提供目标短视频/帖子的短代码值。
问:API 是否返回点赞和观看次数?
答:是的,获取短视频数据返回 like_count、comment_count、play_count 和 video_view_count。
问:有没有免费计划?
答:Zyla 使用订阅 + 配额。第一个 API 通常包括 7 天试用或 50 次请求;请检查列表以获取当前访问选项和定价。
准备将其连接到您的管道了吗?创建您的帐户并直接在列表上开始 7 天试用: 在 Instagram 数据 API 上开始 7 天试用。您的一个 Zyla API 密钥可以在您稍后添加的任何其他 API 中使用。