获取个人资料详细信息的 API

您需要一个 API 来提取 Instagram 个人资料详细信息，您可以在本周内交付。通过本指南的结束，您将提取用户的个人资料（id、用户名、计数、验证、隐私），并且您将知道如何使用 Zyla API Hub 上的生产就绪端点读取短视频、帖子和高亮故事。

您从此 API 获得的内容

Instagram 个人资料和媒体数据 API 暴露只读端点以检索：

• 按用户名获取个人资料详细信息：id、头像、简介、粉丝/关注计数、验证和隐私标志，以及总帖子数。
• 按 URL 或 id 获取帖子详细信息：标题、作者、计数、媒体列表和下载链接。
• 按 URL 或 id 获取短视频详细信息：作者、计数、标题、创建时间和下载 URL。
• 按高亮 id 获取高亮故事详细信息：标题、总故事数，以及每个故事的媒体类型、时间戳、缩略图和下载链接。

这些端点为面向用户的个人资料、CRM 和丰富仪表板、内容审核工具以及媒体摄取工作流提供支持，您必须将公共 Instagram 资源解析为可以缓存和索引的结构化字段。

在 Zyla API Hub 上开始

打开 API 的市场页面，订阅并获取您的密钥。第一个 API 提供 7 天试用或 50 次请求——请查看 API 页面以获取当前访问选项和定价。身份验证通过 HTTP 头进行：Authorization: Bearer YOUR_API_KEY。

• 在 Instagram 个人资料和媒体数据 API 上开始 7 天试用
• 在 Zyla API Hub 上浏览超过 10,000 个公共 API

端点：获取个人资料详细信息

检索给定 Instagram 用户名的个人资料数据。

• 方法：GET
• URL：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
• 所需查询参数：
  • username (string) — 要解析的 Instagram 句柄

cURL 示例

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
}
}

注意：

• 计数是您可以直接显示的整数。
• isPrivateAccount 控制您是否应该尝试获取媒体以进行 UI 预览。
• avatarUrl 是适合直接渲染的 CDN URL；考虑缓存。

Python 示例

此示例调用相同的端点并提取您通常会存储的字段。

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
USERNAME = "a92_mm"

url = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details"
params = {"username": USERNAME}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json().get("data", {})

profile = {
"id": data.get("id"),
"username": data.get("username"),
"full_name": data.get("fullName"),
"avatar_url": data.get("avatarUrl"),
"bio": data.get("biography"),
"followers": data.get("followerCount"),
"following": data.get("followingCount"),
"is_private": data.get("isPrivateAccount"),
"is_verified": data.get("isVerified"),
"total_posts": data.get("totalPosts"),
}

print(profile)

端点：获取帖子详细信息

使用 id 或规范的 Instagram URL 检索特定帖子的详细信息。

• 方法：GET
• URL：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
• 所需查询参数：
  • idOrUrl (string) — 例如 https://www.instagram.com/p/DfALy1PTBSa/

cURL 示例

响应返回字段，如 id、代码、标题、createdAt（Unix 纪元秒）、作者（id、用户名、全名、isVerified、profilePictureUrl）、totalMedia、statistics（likeCount、commentCount）和带有 downloadUrl 条目的 mediaList。

端点：获取短视频详细信息

通过 id 或 URL 检索特定 Instagram 短视频的详细信息。

• 方法：GET
• URL：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
• 所需查询参数：
  • idOrUrl (string) — 例如 https://www.instagram.com/reel/DctYV2qt6S5/

cURL 示例

响应包括顶级字段，如 id、代码、createdAt（Unix 纪元秒）、标题、statistics（commentCount、likeCount）、作者（id、用户名、全名、isVerified、profilePictureUrl）和 downloadUrl。

端点：获取高亮故事详细信息

使用高亮 id 检索特定 Instagram 高亮中的所有故事。

• 方法：GET
• URL：https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
• 所需查询参数：
  • id (string) — 高亮 id，例如 17910014403011985

cURL 示例

响应返回高亮级字段，如 id、标题、totalStories，以及一个 stories 数组，其中每个故事的 id、mediaType（IMAGE 或 VIDEO）、createdAt（Unix 纪元秒）、thumbnailUrl 和 downloadUrl。

实际实施注意事项

• 时间戳：createdAt 值为 Unix 纪元秒。显示时转换为您应用的时区。
• 缓存：个人资料字段和作者头像变化不频繁；缓存几分钟到几小时。媒体 URL 是 CDN 链接，可能会过期；根据需要刷新。
• 隐私：如果 isPrivateAccount 为 true，请不要假设您可以通过其他端点访问媒体。相应地保护您的 UI 和后台作业。
• 媒体处理：downloadUrl 字段是直接链接。流式传输到存储，而不是通过您的 API 代理，以减少出口。
• 错误处理：将非 2xx 视为瞬态，除非您事先验证用户名/URL。记录请求的用户名或 idOrUrl 及 HTTP 状态。
• 配额：计费为订阅 + 配额，而不是按调用计费。跟踪您的调用计数，并使用缓存保持在计划限制内。

端到端工作流示例

注册表单的个人资料丰富

1. 用户在您的产品中输入 Instagram 句柄。
2. 调用获取个人资料详细信息，使用用户名并存储 id、followerCount、isPrivateAccount、isVerified 和 avatarUrl。
3. 在您的 UI 中呈现头像和验证徽章。当 isPrivateAccount 为 true 时禁用媒体预览。

编辑摄取管道

1. 编辑器将帖子 URL 粘贴到您的 CMS 中。
2. 调用获取帖子详细信息，使用 idOrUrl 并提取标题、author.username、statistics.likeCount 和 mediaList[0].downloadUrl。
3. 排队下载器，通过 downloadUrl 获取媒体并将其存储在您的 CDN 中。缓存帖子元数据以快速加载页面。

短视频分析快照

1. 夜间作业迭代短视频 URL 列表。
2. 调用获取短视频详细信息，并保存 statistics.commentCount 和 statistics.likeCount 及时间戳以用于趋势图。

高亮画廊

1. 给定已知的高亮 id，调用获取高亮故事详细信息。
2. 按 createdAt 的时间顺序列出故事。使用 thumbnailUrl 进行网格预览，并在点击后请求全尺寸。

通过 MCP 从 AI 代理调用 API

每个 Zyla API 都可以通过与 MCP 兼容的开发工具（Claude Code、Cursor、Windsurf 等）访问，使用 MCP 端点： https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY。这使您能够将代理连接到调用您在上面看到的相同 Instagram 端点，而无需在代理内部编写自定义网络代码。

在此了解更多信息并将您的密钥插入 MCP 端点： MCP。

为什么要与 Zyla 一起交付

• 一个帐户，一个密钥，一个订阅，适用于您添加到堆栈中的每个 API。
• 一致的 Bearer 身份验证和中心托管的端点，因此您无需在每个供应商的 SDK 之间切换。
• 随时通过浏览 Zyla API Hub 添加更多功能，并使用相同的计费身份进行订阅。

字段映射备忘单

• 个人资料：id、username、fullName、avatarUrl、biography、followerCount、followingCount、isPrivateAccount、isVerified、totalPosts。
• 帖子：id、code、title、createdAt、author{ id、username、fullName、isVerified、profilePictureUrl }、totalMedia、statistics{ likeCount、commentCount }、mediaList[ ]。
• 短视频：id、code、createdAt、title、statistics{ commentCount、likeCount }、author{ ... }、downloadUrl。
• 高亮故事：id、title、totalStories、stories[ { id、mediaType、createdAt、thumbnailUrl、downloadUrl } ]。

交付清单

• 将个人资料 id 与用户名一起存储，以便稳定的外键。
• 将时间戳标准化为 UTC，并在客户端格式化。
• 在瞬态 HTTP 错误上退避并重试；在 4xx 上短路并进行验证。
• 缓存个人资料详细信息和作者图片；设置适合您配额的 TTL。
• 使用 isPrivateAccount 保护媒体提取，并安全处理空媒体数组。

常见问题

此 API 使用什么身份验证？
在每个请求中使用头 Authorization: Bearer YOUR_API_KEY。

我可以通过用户名查询个人资料，通过 URL 查询媒体吗？
可以。获取个人资料详细信息使用用户名。获取帖子详细信息和获取短视频详细信息接受 idOrUrl，因此您可以传递规范的 Instagram URL。

日期的时区是什么？
createdAt 字段为 Unix 纪元秒（UTC）。在客户端转换为用户的时区。

计费是如何处理的？
Zyla 使用订阅 + 配额，而不是按调用计费。第一个 API 提供 7 天试用或 50 次请求；请查看 API 页面以获取当前访问选项和定价。

我可以从 AI 编码代理调用这些端点吗？
可以。使用 MCP 端点 https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY。请参见： MCP。

准备好实现个人资料查找和媒体提取了吗？创建您的帐户，获取 API 密钥，并在列表页面开始您的 7 天试用： 在 Instagram 个人资料和媒体数据 API 上开始 7 天试用。