您需要快速提取可靠的Instagram个人资料详细信息——用户名、验证、关注者数量、隐私状态——以便丰富用户记录、推动注册流程或验证创作者。在本指南结束时,您将能够通过一次请求获取个人资料数据,并了解如何在需要时抓取帖子、短视频和高亮故事的详细信息——所有这些都通过Zyla API Hub上的同一个API密钥。
此API为您提供的内容
Instagram个人资料和媒体数据API返回个人资料元数据(id、用户名、头像URL、关注者和关注数量、验证和隐私标志、总帖子数),并允许您提取帖子、短视频和高亮故事的媒体详细信息。团队使用它来:
- 在入职期间验证创作者和合作伙伴。
- 用关注者数量和验证状态丰富CRM记录。
- 将帖子或短视频URL解析为统计数据和作者信息,以便进行活动跟踪。
- 构建内容选择器和下载管道以获取高亮故事。
所有操作都通过Zyla API Hub进行,只需一个订阅和密钥。您还可以通过MCP端点从AI编码代理调用这些端点。
在Zyla API Hub上开始
打开API页面,订阅并获取您的密钥。新账户上的第一个API通常提供7天的试用或50个请求;请查看API页面以获取当前访问选项和定价。身份验证通过HTTP头Authorization: Bearer YOUR_API_KEY进行。计费是订阅+配额,而不是按调用计费。
端点:获取个人资料详细信息
当您需要Instagram用户的核心身份和公共统计信息时,请使用此API。它返回id、用户名、头像URL、个人简介、类别、关注者/关注数量、隐私和验证标志、总帖子数等可用信息。
- 方法:GET
- URL:https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- 所需参数:username(字符串)
- 身份验证:Authorization: Bearer YOUR_API_KEY
您可以粘贴的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
}
}
您实际会使用的字段说明:
- id:稳定的账户标识符。
- username:当前的用户名(可能会更改;同时存储id和username)。
- avatarUrl:用于渲染的直接CDN链接。
- followerCount,followingCount:用于增长跟踪的整数。
- isPrivateAccount:如果为true,则帖子在没有权限的情况下无法访问;相应地规划您的用户界面。
- isVerified:创作者验证的徽章检查。
- totalPosts:高层次的活动信号。
Python示例(请求)
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details"
params = {"username": "a92_mm"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
data = resp.json()["data"]
print("ID:", data["id"])
print("用户名:", data["username"])
print("已验证:", data["isVerified"])
print("私有:", data["isPrivateAccount"])
print("关注者:", data["followerCount"])
print("关注:", data["followingCount"])
print("总帖子数:", data["totalPosts"])
print("头像URL:", data["avatarUrl"])
其他有用的端点以支持以个人资料为驱动的工作流程
一旦您拥有用户的个人资料,您通常需要深入特定媒体。这些端点帮助您获取单个帖子、短视频或高亮故事的详细页面。所有端点都使用相同的Authorization头,并返回媒体特定字段;时间戳为Unix秒。
获取帖子详细信息
- 方法:GET
- URL:https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- 所需参数:idOrUrl(字符串),例如帖子URL如https://www.instagram.com/p/DfALy1PTBSa/
它的作用:使用id或url检索特定帖子的详细信息。响应包括字段,如id、代码、标题、createdAt(Unix秒)、作者对象(id、用户名、全名、已验证、头像URL)、总媒体、统计信息(likeCount、commentCount)和媒体列表项,包括可用的downloadUrl。使用此功能将分享链接解析为作者元数据和参与统计信息。
获取短视频详细信息
- 方法:GET
- URL:https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- 所需参数:idOrUrl(字符串),例如短视频URL如https://www.instagram.com/reel/DctYV2qt6S5/
它的作用:使用id或url检索特定Instagram短视频的详细信息。响应包括字段,如id、代码、createdAt(Unix秒)、标题、作者对象、统计信息(commentCount、likeCount)和适用的downloadUrl。对于仅从创作者那里获得短视频链接的活动报告非常有用。
获取高亮故事详细信息
- 方法:GET
- URL:https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- 所需参数:id(字符串),高亮ID如17910014403011985
它的作用:使用高亮ID检索特定Instagram高亮中的所有故事。响应包括高亮的id、标题、totalStories和一个stories数组,其中包含字段,如id、mediaType、createdAt(Unix秒)、thumbnailUrl和可用的downloadUrl。使用此功能渲染高亮查看者或备份高亮集。
节省时间的实用集成说明
- 身份验证:始终发送Authorization: Bearer YOUR_API_KEY。
- 时间戳:createdAt字段为Unix秒。使用您语言的标准工具进行转换。
- 私有账户:如果isPrivateAccount为true,预计在其他地方缺少或无法访问媒体;请优雅地处理。
- 缓存:可以将个人资料计数缓存几分钟,以减少重复调用;根据您的用户界面的新鲜需求进行调整。
- IDs与URLs:对于帖子和短视频,idOrUrl允许您直接传递分享链接——在您的应用中无需额外解析步骤。
- 下载:媒体downloadUrl字段指向CDN链接。这些链接可能会过期;按需获取或在使用前刷新URL。
- 配额:访问是订阅+配额。您账户上的第一个API通常提供7天的试用或50个请求;在负载测试之前请在列表页面确认。
现实世界的工作流程
1)创作者入职和验证
当创作者输入他们的Instagram用户名时,调用获取个人资料详细信息以提取isVerified、followerCount和isPrivateAccount。自动拒绝私有或低信号账户,或转到手动审核。将id与用户名一起存储,以保持对用户名更改的弹性。
2)活动表现快照
影响者分享帖子或短视频的链接。将该链接传递到获取帖子详细信息或获取短视频详细信息中,通过idOrUrl,然后记录statistics.likeCount和statistics.commentCount以及author.username。定期重新查询以保持性能历史记录。
3)内容选择器和资产下载
对于作品集,通过获取高亮故事详细信息提取高亮集。使用thumbnailUrl显示故事,并允许用户使用downloadUrl下载资产(如果存在)。请记住,CDN链接可能会过期;及时获取或在渲染下载按钮之前刷新链接。
通过MCP从AI代理调用API
如果您使用Claude Code、Cursor、Windsurf或任何兼容MCP的客户端,您可以让代理通过MCP端点使用您现有的密钥调用Zyla API。提供您的API密钥,并让代理发出上述相同的GET请求;Authorization头保持不变。这对于自动化数据查找或从自然语言提示中搭建集成代码非常有用。
参考:确切的请求URL和参数
- 获取个人资料详细信息(GET):https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- username(字符串,必需)
- 获取帖子详细信息(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
您可以参考的其他官方示例
获取帖子详细信息示例(不需要更改头部)
请求:
响应(摘录):
获取短视频详细信息示例(不需要更改头部)
请求:
响应(摘录):
获取高亮故事详细信息示例(不需要更改头部)
请求:
响应(摘录):
故障排除提示
- 401或403错误:确认Authorization头和您的账户上订阅处于活动状态。
- 空字段:某些个人资料在私有时可能有空白的个人简介/类别或有限字段;处理null和空字符串。
- 过期的媒体URL:如果downloadUrl失败,请重新获取媒体详细信息以获得新链接。
- 格式错误的URL:使用idOrUrl时,传递完整的规范Instagram URL;在构建查询字符串时进行URL编码。
常见问题解答
-
我如何进行请求身份验证?
在每个请求的头部发送Authorization: Bearer YOUR_API_KEY。
-
我可以通过ID而不是用户名获取个人资料吗?
个人资料端点接受用户名。存储返回的id以供内部使用,但按用户名查询,如所示。
-
如果我只有帖子或短视频的分享链接怎么办?
在获取帖子详细信息或获取短视频详细信息中使用idOrUrl与确切的Instagram链接。API将解析并返回作者、统计信息和媒体字段。
-
时间戳是否以标准格式出现?
是的。createdAt字段为Unix时间戳(秒)。在您的应用中转换为您的本地时区。
-
是否有免费计划?
访问是订阅+配额。您账户上的第一个API通常提供7天的试用或50个请求——请查看API页面以获取当前访问选项和定价。
准备好发布您的集成了吗?请在Instagram个人资料和媒体数据API页面上订阅并获取您的密钥。您的7天试用从那里开始,您可以使用同一个密钥调用个人资料、帖子、短视频和高亮端点:在Instagram个人资料和媒体数据API上开始7天试用