您需要以编程方式获取Instagram故事或短视频的URL，以便进行下游处理——渲染预览、审核内容或将资产保存到存储中——并且您需要在本周内完成。通过本指南的结束，您将能够调用一个生产端点，该端点接受公共的Instagram故事或短视频URL并返回媒体有效载荷，使用来自Zyla API Hub的一个API密钥。
此API的功能及使用时机
Instagram故事下载器API提供了一项专注的功能：给定Instagram短视频或故事的URL，它尝试解析并返回底层媒体。这对于以下情况非常有用：
- 构建需要在重新发布之前获取源媒体的社交媒体调度程序。
- 提取媒体以进行自动检查的内容审核工作流。
- 保存用户提交的Instagram链接的备份和归档服务。
- 需要确定性媒体URL以进行处理的数据摄取管道。
它是Zyla API Hub上社交媒体与网络类别的一部分，提供超过10,000个可直接使用的API，使用一个账户和一个密钥。订阅是基于配额的（不是按调用计费）。对于此API，您可以从7天的试用或50个请求开始——请查看API页面以获取当前的访问选项和定价。
在Zyla API Hub上开始
获取API密钥：
- 打开Instagram故事下载器API的市场列表并开始试用。
- 订阅以获取您的API密钥。
- 使用Authorization: Bearer YOUR_API_KEY调用端点。
使用此直接链接开始：在Instagram故事下载器API上开始7天试用。您还可以在Zyla API Hub上浏览其他社交媒体API。
端点：获取故事和短视频
此API公开一个端点，以从提供的Instagram故事或短视频URL中检索媒体。
- 方法：GET
- URL：https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels
- 所需查询参数：
- url（字符串）：故事或短视频的完整Instagram URL。示例：https://www.instagram.com/reel/DL74pQBRymc/
- 身份验证：HTTP头Authorization: Bearer YOUR_API_KEY
重要：在构建请求时对url参数进行URL编码。下面的示例已经包含了正确的编码。
官方cURL示例
curl -s -X GET "https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDL74pQBRymc%2F" \
-H "Authorization: Bearer YOUR_API_KEY"官方示例响应
{
"media": [],
"error": "无效的Instagram链接格式！目前，我们仅支持图片、短视频和IGTV。"
}字段说明：
- media：一个数组，旨在包含在URL有效且受支持时解析的媒体对象。
- error：描述解析失败时发生了什么的消息（例如，不支持或格式错误的URL）。
在集成时，将错误视为权威。如果error非空或media为空，请优雅地处理（例如，提示用户提供不同的链接，记录并稍后重试，或显示用户可见的验证消息）。
工作Python示例
下面的代码片段调用相同的端点，解析JSON，并演示基本的错误处理。将YOUR_API_KEY替换为您从Zyla API Hub订阅中获得的实际密钥。
import requests
import urllib.parse
API_KEY = "YOUR_API_KEY"
endpoint = "https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels"
# 始终对Instagram链接进行URL编码，以便作为`url`查询参数
ig_link = "https://www.instagram.com/reel/DL74pQBRymc/"
params = {
"url": urllib.parse.quote(ig_link, safe="")
}
# 构建最终URL，使用API期望的编码参数
final_url = f"{endpoint}?url={params['url']}"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(final_url, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# 最小解析：如果存在，优先使用`error`，否则使用`media`
if data.get("error"):
print("API报告了一个错误：", data["error"])
else:
media_items = data.get("media", [])
print(f"解析了{len(media_items)}个媒体项。")
# 示例迭代（项的结构取决于API响应）
for i, item in enumerate(media_items, 1):
# 使用字典访问防御性，因为字段在此处未记录
# 例如，可能的键包括'url'、'type'等（检查实时响应）
print(f"项 {i}: {item}")节省时间的开发者笔记
- URL编码：在将Instagram URL作为url查询参数发送时，始终进行编码。上面的curl显示了正确的编码。
- 身份验证：使用单个头部——Authorization: Bearer YOUR_API_KEY。不要将密钥放在查询字符串中。
- 输入验证：验证用户提供的完整Instagram URL是否代表短视频或故事。示例响应演示了您可能会看到的错误消息，提示不支持或格式错误的链接。
- 重试：如果您收到瞬态HTTP错误，请退后并重试。在JSON主体中出现一致的错误字段时，将其呈现给用户，而不是重试。
- 缓存：如果您的工作流重复处理热门链接，请通过规范的Instagram URL缓存成功的媒体解析，以减少重复请求。
- 配额：访问是订阅+配额（不是按调用计费）。对于此API，您可以从7天的试用或50个请求开始；在负载测试之前，请在列表页面验证您的当前限制。
实际使用案例
1）社交内容摄取
让用户粘贴短视频URL；解析媒体；将其上传到您的存储；附加元数据；排队进行转换（例如，转码、剪辑或缩略图生成）。通过在URL不受支持时显示清晰的提示来处理错误路径。
2）审核管道
从短视频或故事链接解析媒体，然后通过您的审核堆栈运行。通过一致的输入（单个Instagram URL），您可以在服务之间标准化处理和日志记录。
3）创作者工具
构建一个简单的“从Instagram导入”功能，将短视频解析到编辑时间线中。当API通过错误字段标记不支持的链接格式时，提供即时反馈。
4）归档和备份
当用户提供链接作为参考时，使用此端点获取媒体并进行归档。存储原始Instagram URL和解析时间戳以便审计。
如何通过MCP从AI代理调用它
Zyla上的每个API也可以通过模型上下文协议（MCP）调用，该协议与MCP兼容的工具一起使用。将您的客户端指向MCP网关： https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
在您的MCP客户端中，配置一个工具，使其对以下内容发出GET请求：
- https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels
- 头部：Authorization: Bearer YOUR_API_KEY
- 查询参数：url（URL编码的Instagram链接）
连接后，您的代理可以接受短视频/故事URL作为输入，并将解析的JSON（媒体或错误）返回到您的编码会话中。有关MCP本身的参考材料，请参见：MCP。
端到端检查清单
- 通过在列表页面上订阅获取API密钥。
- 确保在作为url传递时对Instagram URL进行URL编码。
- 在每个请求中发送Authorization: Bearer YOUR_API_KEY。
- 检查JSON是否有错误；如果存在，请不要假定媒体可用。
- 记录原始输入URL和API响应以进行调试和审计。
- 按规范的Instagram URL缓存成功的解析。
常见问题
该端点支持哪些内容类型？
错误消息指示支持图片、短视频和IGTV。如果您传递不在API支持范围内的格式或无效链接，请期待类似于示例响应中的错误消息。
我如何进行身份验证？
包括一个HTTP头：Authorization: Bearer YOUR_API_KEY。不要在查询字符串中包含密钥。
我需要对Instagram链接进行URL编码吗？
是的。url查询参数必须包含一个URL编码的Instagram链接。官方的curl示例显示了正确的编码。
当API返回错误字段时，我该怎么办？
将错误视为该请求的权威结果。向用户显示验证消息，允许更正，或记录并停止处理。如果错误指示不支持的格式，请避免重试。
是否有免费计划？
没有免费计划。访问是订阅+配额，第一步选项为7天试用或50个请求。请查看API页面以获取当前访问选项。
准备好发布您的Instagram短视频/故事集成了吗？在此处开始您的试用并获取API密钥：Zyla API Hub上的Instagram故事下载器API。一旦订阅，您可以在几分钟内发出第一个请求，并将响应插入到您的社交工作流中。
