您需要以编程方式获取您已经拥有的 URL 的完整 Instagram 帖子详情（标题/说明、作者、计数、媒体 URL）。通过本指南的结束，您将从单个端点检索这些字段，在代码中解析它们，并知道去哪里获取短视频和高亮故事——所有这些都只需一个 API 密钥在 Zyla API Hub 上。
您将使用此 API 构建什么
Instagram 个人资料和媒体数据 API 返回您已经通过 URL 或 ID 知道的 Instagram 内容的结构化详情。您可以：
- 将帖子 URL 解析为其 ID、说明/标题、作者信息、点赞/评论计数和媒体下载 URL。
- 通过 URL 查找短视频并读取其作者、互动和可下载的媒体链接。
- 将 Instagram 高亮（通过高亮 ID）扩展为其单独的故事及媒体 URL。
开发人员使用此功能来支持 CMS 导入、反向链接预览、社交证明小部件、提要镜像和自动归档流程。
在 Zyla API Hub 上开始
打开 Zyla API Hub 上的 API 列表并开始 7 天试用（或在可用时使用 50 请求选项）以获取您的密钥。计费是订阅 + 配额，而不是按调用付费，并且没有免费计划。您的 API 密钥通过授权头授权请求。
在 Instagram 个人资料和媒体数据 API 上开始 7 天试用
通过 Zyla API Hub 的一个密钥，您可以调用跨类别的数千个 API。相同的订阅模型和密钥适用于整个市场。
您要的端点：获取帖子详情
使用其 URL（或您已经拥有的 ID）检索特定 Instagram 帖子的详细信息。
- 方法：GET
- 请求 URL：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- 所需查询参数：idOrUrl（字符串）
示例：传递帖子 URL。
curl -s -X GET "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details?username=a92_mm" \
-H "Authorization: Bearer YOUR_API_KEY"官方示例响应
{
"data": {
"id": "8640409651",
"username": "a92_mm",
"fullName": "",
"avatarUrl": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/117330532_764310710994941_3178952573818498232_n.jpg?_nc_cat=105&ig_cache_key=GGRS-gb9R230IrcCALjsQ_iF6B0sbkULAAAB0j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy42NTYuQzMifQ%3D%3D&_nc_ohc=UhqRB5XucjcQ7kNvwHzZrZa&_nc_oc=AdqQKMjA1CNJE2cZFGaOKLPAekcrEXjIih5fmtbyZIyBJ-ZZBqfAyZouTn139aCO8yM&_nc_zt=24&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_ss=7b62e&oh=00_AQSK1vbEqHI8iXnKTfwnP4mNcPHclgCyRAq7u5j4Lij_Pg&oe=6AE96358",
"biography": "",
"category": "",
"bioLinks": [],
"linkedFacebookInfo": null,
"followerCount": 5,
"followingCount": 34,
"isPrivateAccount": true,
"isVerified": false,
"totalPosts": 9
}
}实施者的字段说明：
- data.id 和 data.code 标识帖子；code 映射到 /p/{code} 路径。
- data.title 是帖子说明/标题。将其存储为 UTF‑8。
- data.createdAt 是 Unix 时间戳（秒）。根据需要在您的时区处理时转换。
- data.author 包括规范用户名、验证状态和头像 URL。
- data.statistics.likeCount 和 commentCount 提供互动指标。
- data.mediaList 包含您可以直接获取的可下载媒体 URL。遵守目标主机的缓存和链接过期政策；如果您需要稳定的资产，请在您的一侧缓存解析的文件。
Python 示例：通过 URL 获取帖子并读取关键字段
import os
import requests
from datetime import datetime, timezone
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
POST_URL = "https://www.instagram.com/p/DfALy1PTBSa/"
endpoint = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details"
params = {"idOrUrl": POST_URL}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(endpoint, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json().get("data", {})
post_id = data.get("id")
code = data.get("code")
title = data.get("title", "")
created_at = data.get("createdAt")
dt = datetime.fromtimestamp(created_at, tz=timezone.utc) if created_at else None
author = data.get("author", {})
username = author.get("username")
is_verified = author.get("isVerified")
stats = data.get("statistics", {})
likes = stats.get("likeCount")
comments = stats.get("commentCount")
media = data.get("mediaList", [])
first_download_url = media[0].get("downloadUrl") if media else None
print("Post:", post_id, code)
print("Author:", username, "(verified)" if is_verified else "")
print("Caption:", title)
print("Created at (UTC):", dt)
print("Engagement: likes =", likes, ", comments =", comments)
print("First media URL:", first_download_url)您可能需要的其他可用端点
如果您的集成超出了静态帖子，则相同的 API 涵盖短视频和高亮故事。
获取短视频详情
- 方法：GET
- 请求 URL：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- 所需查询参数：idOrUrl（字符串），例如短视频 URL
这将返回短视频的 id、code、作者块、createdAt、标题、统计信息（点赞/评论计数）和下载 URL。将 createdAt 处理为 Unix 纪元（秒），并存储 author.username 以进行归属。
获取高亮故事详情
- 方法：GET
- 请求 URL：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- 所需查询参数：id（字符串），即高亮 ID
当您已经知道高亮 ID 并需要所有包含的故事时使用此功能。您将收到高亮的标题、totalStories，以及每个故事的 mediaType、createdAt、thumbnailUrl 和 downloadUrl 的故事数组。
官方中心列表示例（个人资料详情）
该 API 还公开了个人资料查找。以下是 Zyla Hub 列表的官方示例供参考。
如果您计划跟踪随时间变化的指标，请存储 followerCount/totalPosts 快照。isPrivateAccount 可能会限制下游媒体端点可以返回该用户的内容。
实用实施说明
- 身份验证：在每个请求中发送 Authorization: Bearer YOUR_API_KEY。
- 时间戳：createdAt 字段是 Unix 纪元秒。使用 UTC 转换，然后在需要时格式化为用户的时区。
- 媒体下载：downloadUrl 和 thumbnailUrl 指向 CDN 资源。这些链接可能会过期；如果您需要持久性，请下载并将资产存储在您自己的存储中，并进行缓存验证。
- 错误处理：将空数据或缺失字段视为非致命；社交内容可能已被删除或限制。
- 请求量：中心使用订阅 + 配额（而不是按调用付费）。首次访问选项为 7 天试用或 50 次请求（如可用）。请检查 API 页面以获取当前访问选项和定价。
通过 MCP 从 AI 代理调用这些端点
如果您通过 AI 编码工具（Claude Code、Cursor、Windsurf 或任何 MCP 兼容客户端）进行自动化，您可以通过 Zyla 的 MCP 端点路由请求：
- 代理端点：https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
- 工具文档：MCP
在您的代理中公开一个工具，调用上述文档中的确切中心 URL，传递授权头，并解析相同的 JSON 结构。将业务逻辑（例如，选择第一个 mediaList 项）保留在代理的工具代码中，以最小化模型令牌。
您本周可以交付的端到端示例
- 在 CMS 中自动嵌入帖子：将 idOrUrl 解析为标题、author.username、statistics.likeCount 和 mediaList[0].downloadUrl；缓存 24 小时；在发布时重新验证。
- 每周互动快照：定期获取您关心的帖子并记录 statistics.likeCount/commentCount 和 createdAt 以生成趋势图。
- 短视频功能轨道：通过 URL 获取短视频详情，显示 author.profilePictureUrl、标题和绑定到 downloadUrl 的播放按钮。
- 高亮画廊：对于已知的高亮 id，在网格中列出 stories[].thumbnailUrl；单击时，流 stories[].downloadUrl。
参考：真实端点和参数
- 获取帖子详情（GET）：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- 所需参数：idOrUrl（字符串），例如 https://www.instagram.com/p/DfALy1PTBSa/
- 获取短视频详情（GET）：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- 所需参数：idOrUrl（字符串），例如 https://www.instagram.com/reel/DctYV2qt6S5/
- 获取高亮故事详情（GET）：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- 所需参数：id（字符串），例如 17910014403011985
- 获取个人资料详情（GET，列表示例）：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- 所需参数：username（字符串）
在 Zyla API Hub 上探索更多类别；市场上列出了超过 10,000 个公共 API，均在一个账户和密钥下。
常见问题
我该如何进行身份验证？
在每个请求中发送 HTTP 头：Authorization: Bearer YOUR_API_KEY。
createdAt 的格式是什么？
Unix 纪元秒。转换为 UTC 的日期时间，然后格式化为您首选的时区。
媒体 URL 会过期吗？
会。如果您需要稳定的资产，请获取 downloadUrl 并将内容存储在您自己的存储中，遵守来源条款。
有免费计划吗？
没有免费计划。您可以开始 7 天试用或在可用时进行 50 次请求；请检查 API 页面以获取当前访问选项和定价。
我可以从 AI 代理调用这些端点吗？
可以。使用 MCP 网关 https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY，并让代理调用相同的中心 URL，带上授权头。
准备好交付了吗？获取您的密钥并开始从列表页面调用端点： 在 Instagram 个人资料和媒体数据 API 上开始 7 天试用。
