您需要可靠的 Instagram 帖子和个人资料数据,以便在本周内将其投入生产工作流程。通过本文,您将能够使用 Zyla API Hub 上的 Instagram 数据 API 获取帖子级别的详细信息(尺寸、媒体 URL、标题、互动信号)和个人资料级别的数据(用户名、简介、验证、图片、链接),并提供可复制粘贴的请求和集成准备模式。
您可以使用 Instagram 数据 API 构建的内容
Instagram 数据 API 提供了两个开发人员常规需要的高信号读取端点,用于社交媒体功能:
- 帖子信息:通过其短代码查找帖子以检索媒体元数据(图像/视频标志、尺寸、URL)、标题文本、所有者个人资料摘要和互动字段。
- 个人资料详细信息:通过用户名或 ID 查找个人资料以检索验证状态、个人资料图片、关注者上下文、简介、外部链接和其他帐户描述符。
这些端点对于社交分析仪表板、品牌监控、自动内容审核、链接丰富、个人资料验证检查以及在渲染之前需要确定性媒体属性的帖子嵌入管道非常有用。
在 Zyla API Hub 上开始
打开 Zyla API Hub 上的 API 列表并订阅以获取您的密钥。该 Hub 采用订阅 + 配额模型(而非按调用付费)。对于第一个 API,您可以开始 7 天试用或 50 次请求。请查看 API 页面以获取当前访问选项和定价。
- 开始 Instagram 数据 API 的 7 天试用
- 浏览超过 10,000 个公共 API,访问 Zyla API Hub
每个请求都通过 HTTP 头部 Authorization: Bearer YOUR_API_KEY 发送身份验证。
您将使用的端点
1) 帖子信息
方法:GET
URL: https://zylalabs.com/api/855/instagram-data-api/37566/post-information
所需查询参数:
- code (string):Instagram 帖子的短代码。示例:DfI02-LTwkc
返回内容:详细的 Instagram 帖子信息,包括短代码、媒体尺寸、图像 URL、视频标志、标题、所有者个人资料详细信息、发布日期、点赞和评论。
官方 curl 示例:
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37566/post-information?code=DfI02-LTwkc" \
-H "Authorization: Bearer YOUR_API_KEY"
官方 JSON(逐字)响应示例:
{
"status": "ok",
"data": {
"post": {
"__typename": "GraphVideo",
"id": "4019695143460210972",
"shortcode": "DfI02-LTwkc",
"dimensions": {
"height": 718,
"width": 1020
},
"display_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7020f&oh=00_AQSFeFgTX4qgUU-VPIinjkrZASMg4NkxlFyIzab67V5zow&oe=6AEB0083",
"is_video": true,
"accessibility_caption": "视频由特斯拉于 2026 年 10 月 30 日发布。可能是豪华轿车、小型面包车、夜晚和文本的图像。",
"display_resources": [
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQR9wbRhfpvbBzM62jt9275twGnXRdiKlpV7kHlOv-NxBw&oe=6AEB0083",
"config_width": 720,
"config_height": 506
},
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQS1dgCJVbPnKwyP9gf442dDrUD3XTZzXdzz-VZ9sltSKA&oe=6AEB0083",
"config_width": 640,
"config_h…
您将在响应中常见的字段:
- post.shortcode:您查询的唯一帖子短代码。
- post.is_video:布尔标志,告诉您是否应该期待视频资产。
- post.dimensions.width/height:用于调整容器大小或生成响应式占位符。
- post.display_url 和 post.display_resources[i].src:您可以根据需要存储或缓存的媒体 URL。
- post.accessibility_caption:用于替代文本或内容审核。
2) 个人资料详细信息
方法:GET
URL: https://zylalabs.com/api/855/instagram-data-api/37572/profile-details
所需查询参数:
- id_or_username (string):Instagram 用户名或数字 ID。示例:cristiano
返回内容:详细的 Instagram 个人资料信息,包括用户名、传记、验证状态、个人资料图片、关注者和关注计数、外部链接、故事高亮和帐户详细信息。
官方 curl 示例:
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37572/profile-details?id_or_username=cristiano" \
-H "Authorization: Bearer YOUR_API_KEY"
官方 JSON(逐字)响应示例:
{
"status": "ok",
"data": {
"user": {
"pk": "173560420",
"username": "cristiano",
"profile_pic_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.2885-19/472007201_1142000150877579_994350541752907763_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=YjSGq_4F5PwQ7kNvwGAf5GW&_nc_oc=AdrE9TNJ3DCmDwEYUzm5V1uTncNAl5vdTNunoBb6plzuRC7AMBnUZ4VPbRqG3H4p4dc&_nc_zt=24&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_ss=7060f&oh=00_AQQkDdv_NHNUxezd5SGePgHmJXPwMrXfPk1NrU-e_bz62w&oe=6AEB1EDE",
"is_private": false,
"is_unpublished": false,
"latest_reel_media": 0,
"biography": "",
"full_name": "Cristiano Ronaldo",
"is_verified": true,
"text_post_app_badge_label": null,
"show_text_post_app_badge": false,
"account_badges": [],
"bio_links": [
{
"image_url": "",
"is_pinned": false,
"link_id": "18122242507586533",
"link_type": "external",…
您将在响应中常见的字段:
- user.username 和 user.pk:您用户存储的规范键。
- user.is_verified 和 user.is_private:用于验证检查和访问流。
- user.profile_pic_url:显示头像或存储以进行 CDN 缓存。
- user.full_name 和 user.biography:用于嵌入帖子旁边的丰富作者卡。
- user.bio_links:提取平台外目的地以进行链接分析或合作伙伴归因。
您可以粘贴的端到端示例
Python:获取帖子信息并为渲染进行规范化
此 Python 示例调用帖子信息端点,提取媒体大小、替代文本和前端的首选显示 URL。
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
SHORTCODE = "DfI02-LTwkc"
url = "https://zylalabs.com/api/855/instagram-data-api/37566/post-information"
params = {"code": SHORTCODE}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
post = data.get("data", {}).get("post", {})
is_video = post.get("is_video")
dims = post.get("dimensions", {})
width, height = dims.get("width"), dims.get("height")
# 选择显示资源:如果可用,则选择最高的 config_width,否则回退到 display_url
display_resources = post.get("display_resources", []) or []
best = None
if display_resources:
best = max(display_resources, key=lambda r: r.get("config_width", 0))
display_src = (best or {}).get("src") or post.get("display_url")
normalized = {
"shortcode": post.get("shortcode"),
"is_video": is_video,
"width": width,
"height": height,
"src": display_src,
"alt": post.get("accessibility_caption") or "",
}
print(normalized)
JavaScript (Node.js):通过用户名获取个人资料详细信息
此 Node.js 代码片段请求公共个人资料并提取验证和头像元数据以用于作者徽章组件。
import fetch from "node-fetch";
const API_KEY = process.env.ZYLA_API_KEY || "YOUR_API_KEY";
const username = "cristiano";
const url = "https://zylalabs.com/api/855/instagram-data-api/37572/profile-details?id_or_username=" + encodeURIComponent(username);
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
}
});
if (!res.ok) {
throw new Error(`请求失败:${res.status} ${res.statusText}`);
}
const json = await res.json();
const user = (json.data && json.data.user) || {};
const author = {
username: user.username,
fullName: user.full_name,
verified: user.is_verified === true,
private: user.is_private === true,
avatar: user.profile_pic_url || null
};
console.log(author);
实际实施注意事项
- 短代码输入:帖子信息端点需要帖子的短代码(而不是完整 URL)。将短代码存储为您查询帖子的规范键。
- 选择图像变体:响应包括多个尺寸的 display_resources。选择您支持的最大 config_width,以减少布局偏移。
- 替代文本:accessibility_caption 是替代文本的强大默认值。如果缺失,请优雅地回退。
- 缓存:媒体 URL 可能会更改;缓存规范化有效负载(短代码 → 选择的图像、宽度/高度、替代文本),并根据适合您 UI 的时间表实现刷新。
- 错误处理:在解引用字段之前,始终检查 data.data.post 或 data.data.user 的存在。
- 配额:Zyla 使用订阅 + 配额。监控您的请求使用情况,并实现简单的本地缓存,以避免在热路径中重复查询。
您可以在本周交付的常见社交媒体使用案例
1) 内容编辑器中的帖子预览卡
让编辑者粘贴 Instagram 帖子 URL,解析短代码,并调用帖子信息以预填充带有媒体、尺寸和标题片段的预览卡。存储规范化有效负载以便立即渲染,并使用宽度/高度避免布局跳跃。
2) 带有验证和头像的作者徽章
当您渲染 Instagram 帖子或引用时,通过用户名调用个人资料详细信息,以显示准确的头像、显示名称和基于 user.is_verified 的验证徽章。
3) 品牌监控管道
保持用户名的观察列表,并定期刷新个人资料详细信息,以跟踪验证更改、用户名更新或简介链接更改。下游警报可以在 bio_links 或 is_private 切换更改时触发。
4) 丰富的链接分析
当合作伙伴列出他们的 Instagram 账号时,使用个人资料详细信息确认该账号存在,并提取 bio_links 以发现他们的平台外目的地,然后再路由流量或归因转化。
5) 内容审核和可访问性检查
使用 accessibility_caption 作为自动替代标记检查的信号。在需要合规或可访问性标准的工作流程中标记缺少替代内容的帖子。
通过 MCP 从 AI 代理调用 API
您可以将相同的端点连接到支持模型上下文协议(MCP)的 AI 代理,包括 Claude Code、Cursor 和 Windsurf。配置您的代理以调用 Zyla 的 MCP 网关:
- 端点: MCP
- API 密钥:传递由您的 MCP 兼容客户端配置的 YOUR_API_KEY
在运行时,您的代理可以请求上述相同的 URL。保持身份验证一致:Authorization: Bearer YOUR_API_KEY。
生产的操作提示
- 尽早规范化:将响应转换为稳定的内部形状(例如,Post {shortcode, isVideo, w, h, src, alt})。将其与时间戳一起存储以进行缓存失效。
- 重试策略:在 5xx 网络故障上实施简短的、有界的重试;记录 4xx 响应以便可见性并避免循环。
- 安全渲染:始终保护可选字段(例如,display_resources 可能缺失;回退到 display_url)。
- 批处理模式:在丰富用户名队列时,错开调用并在时间窗口内去重,以保持在您的订阅配额内。
参考:官方示例(由 Hub 返回)
帖子信息:cURL
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37566/post-information?code=DfI02-LTwkc" \
-H "Authorization: Bearer YOUR_API_KEY"
帖子信息:JSON
{
"status": "ok",
"data": {
"post": {
"__typename": "GraphVideo",
"id": "4019695143460210972",
"shortcode": "DfI02-LTwkc",
"dimensions": {
"height": 718,
"width": 1020
},
"display_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7020f&oh=00_AQSFeFgTX4qgUU-VPIinjkrZASMg4NkxlFyIzab67V5zow&oe=6AEB0083",
"is_video": true,
"accessibility_caption": "视频由特斯拉于 2026 年 10 月 30 日发布。可能是豪华轿车、小型面包车、夜晚和文本的图像。",
"display_resources": [
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQR9wbRhfpvbBzM62jt9275twGnXRdiKlpV7kHlOv-NxBw&oe=6AEB0083",
"config_width": 720,
"config_height": 506
},
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQS1dgCJVbPnKwyP9gf442dDrUD3XTZzXdzz-VZ9sltSKA&oe=6AEB0083",
"config_width": 640,
"config_h…
个人资料详细信息:cURL
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37572/profile-details?id_or_username=cristiano" \
-H "Authorization: Bearer YOUR_API_KEY"
个人资料详细信息:JSON
{
"status": "ok",
"data": {
"user": {
"pk": "173560420",
"username": "cristiano",
"profile_pic_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.2885-19/472007201_1142000150877579_994350541752907763_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=YjSGq_4F5PwQ7kNvwGAf5GW&_nc_oc=AdrE9TNJ3DCmDwEYUzm5V1uTncNAl5vdTNunoBb6plzuRC7AMBnUZ4VPbRqG3H4p4dc&_nc_zt=24&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_ss=7060f&oh=00_AQQkDdv_NHNUxezd5SGePgHmJXPwMrXfPk1NrU-e_bz62w&oe=6AEB1EDE",
"is_private": false,
"is_unpublished": false,
"latest_reel_media": 0,
"biography": "",
"full_name": "Cristiano Ronaldo",
"is_verified": true,
"text_post_app_badge_label": null,
"show_text_post_app_badge": false,
"account_badges": [],
"bio_links": [
{
"image_url": "",
"is_pinned": false,
"link_id": "18122242507586533",
"link_type": "external",…
测试和监控
- 烟雾测试:添加 CI 步骤,请求已知的短代码和用户名,并在部署 UI 更改之前断言所需字段的存在。
- 可观察性:记录解码失败及原始请求 URL(无秘密),以快速调试参数问题。
- 退避:在重复的非 200 响应上,退避并显示仪表板警报——不要旋转。
常见问题解答
问:我如何进行身份验证?
答:在每个请求中包含头部 Authorization: Bearer YOUR_API_KEY。
问:我在哪里可以获得 API 密钥?
答:打开市场列表并点击订阅或开始免费试用,然后从仪表板复制您的密钥。
问:每个端点需要哪些参数?
答:帖子信息需要 code(帖子短代码)。个人资料详细信息需要 id_or_username(用户名或数字 ID)。
问:我可以从 AI 编码代理调用这些端点吗?
答:可以。使用 Zyla 的 MCP 网关,并配置您的代理转发相同的 URL 和 Authorization 头。请参见 MCP 端点。
问:是否有免费计划?
答:没有免费计划。该 Hub 使用订阅 + 配额,对于第一个 API,您可以开始 7 天试用或 50 次请求。请查看列表以获取当前访问选项。
准备好交付您的 Instagram 集成了吗?创建一个帐户,订阅并开始使用 Instagram 数据 API 在 Zyla API Hub 上构建。