GrabMP4 API

Download direct video URLs from YouTube, Instagram, Reddit, X, TikTok and Threads with a simple 2-step API.

原始信息汇总

GrabMP4 API 数据集概述

基本描述

GrabMP4 API 帮助您将公共社交媒体帖子URL解析为可下载的媒体链接。

核心功能

• 提供简单的两步流程，将公共社交媒体帖子URL转换为直接下载链接。
• 支持通过统一的端点结构处理6个主要的社交视频平台。
• 提供标准化的JSON响应和错误处理。
• 适用于应用程序、机器人、自动化工具和下载工具的快速集成。

支持平台

接受的 platform 值（用于 POST /media）：

• ig
• reddit
• threads
• tiktok
• x
• youtube

返回的 source 值（在 POST /media 响应中）：

• instagram
• reddit
• threads
• tiktok
• twitter
• youtube

工作原理

1. 步骤1： 使用公共帖子URL和平台信息向 POST /media 发送请求。
2. 步骤2： 使用从步骤1返回的掩码GrabMP4 URL向 GET /media 发送请求。
3. 结果： 接收最终的直接 downloadUrl。

端点详情

基础URL： https://grabmp4-api.p.rapidapi.com

1. POST /media

• 功能： 将公共社交媒体帖子URL解析为掩码GrabMP4 URL。
• 请求体字段：
  • platform（必需，字符串）：接受的值：ig, reddit, threads, tiktok, x, youtube。
  • url（必需，字符串）：公共帖子URL。
• 成功响应字段示例：
  • title（字符串）
  • thumbnail（字符串）
  • formats（数组）
    • formats[].quality（字符串）
    • formats[].url（字符串）：这是用于 GET /media 的掩码GrabMP4 URL。
  • source（字符串）

2. GET /media

• 功能： 将掩码GrabMP4 URL解析为最终的直接下载URL。
• 查询字段：
  • url（必需，字符串）：必须是 POST /media 返回的完整掩码GrabMP4 URL。
• 成功响应字段示例：
  • platform（字符串）
  • downloadUrl（字符串）：最终的直接文件URL。
  • title（字符串或 null）
  • quality（字符串或 null）
  • type（字符串或 null）

3. GET /health

• 功能： 健康检查端点。
• 成功响应示例： {"ok": true, "service": "grabmp4-api", "time": "2026-03-21T14:47:08.078Z"}

认证

• 对于RapidAPI订阅者： 标准RapidAPI认证（X-RapidAPI-Key 和 X-RapidAPI-Host）即可。
• 内部直接访问认证： 如果直接调用原始Vercel端点（而非通过RapidAPI网关），API还需要 x-rapidapi-proxy-secret 头。

错误处理

错误以JSON格式返回，包含 error 和 code 字段。常见错误代码包括：

• INVALID_API_KEY
• PLATFORM_REQUIRED
• URL_REQUIRED
• UNSUPPORTED_PLATFORM
• NO_MEDIA_FOUND
• INTERNAL_ERROR 等。

使用说明

• 一个完整的下载通常使用2个API请求：一个 POST /media 和一个 GET /media。
• POST /media 返回的是掩码GrabMP4 URL，而非最终的源URL。
• GET /media 默认在JSON中返回最终的直接下载URL。
• 在标准的RapidAPI使用中，用户无需单独传递 token；GET /media 唯一必需的输入是 POST /media 返回的完整掩码URL。

适用场景

• 社交媒体下载器应用程序
• 内容实用工具
• 内部自动化
• 机器人和工作流集成
• 创作者工具和媒体管道