FastGram Scraper

Get Instagram profile content easily! Get photos, videos, captions, and engagement data from public profiles for analytics, automation, or social insights.

原始信息汇总

FastGram Scraper 数据集概述

数据集基本信息

• 名称：FastGram Scraper
• 类别：Social
• 提供者：ScraperPunk
• 订阅者数量：16
• 访问地址：https://rapidapi.com/scraperpunk-scraperpunk-default/api/fastgram-scraper
• 服务等级：100% Service Level
• 延迟：320ms Latency
• 测试通过率：100% Test
• 受欢迎程度：9.1 Popularity

定价计划

• BASIC：$0.00 / mo
• PRO：$15.00 / mo
• ULTRA：$55.00 / mo
• MEGA：$125.00 / mo

核心功能描述

FastGram API 允许从任何公开的 Instagram 个人资料即时、可靠且大规模地获取最新帖子。通过简单的 API 调用，可以检索照片、视频、标题、标签、时间戳和参与度指标，所有数据均以简洁且对开发者友好的 JSON 格式提供。

关键特性

• 完整的媒体数据：直接获取图像和视频的 URL。
• 标题和标签：适用于社交媒体内容分析和关键词跟踪。
• 发布时间戳：适用于帖子排期和趋势监控。
• 参与度指标：点赞、评论和其他公开互动数据（在可用时）。
• 高性能：快速、轻量级，兼容任何语言或框架。
• 始终保持最新：构建用于处理 Instagram 频繁的平台变更。

主要用途

• 社交媒体分析：跟踪影响者或品牌的发帖频率、参与度和增长。
• 营销自动化：将实时内容输入到仪表板、CRM 或机器人中。
• 内容聚合：在网站和移动应用上显示实时 Instagram 帖子。
• 研究与监控：跟踪公共趋势、标签或活动动态。

技术架构与特性

该 API 基于 Node.js、TypeScript 和 MongoDB 构建，主要特性包括：

• JWT 身份验证：基于令牌的安全身份验证。
• 后台处理：使用 Bull 和 Redis 的异步作业队列。
• 数据持久化：具有自动缓存的 MongoDB 存储。
• 实时更新：通过 Redis Pub/Sub 提供 WebSocket 支持。
• 速率限制：内置速率限制以遵守 Instagram 的限制。
• 错误处理：全面的错误跟踪和恢复。

主要端点与操作

数据抓取

• 启动抓取作业

  • 端点：POST /api/scrape/user/:username
  • 功能：为指定 Instagram 用户名启动抓取作业。
  • 可选参数：webhookUrl（作业完成时的回调 URL）、webhookToken（回调验证令牌）。
  • 作业类型：user（仅抓取用户资料）、posts（仅抓取帖子）、both（抓取用户资料和帖子，默认）。

• 获取作业状态

  • 端点：GET /api/scrape/jobs/:jobId
  • 功能：查询指定抓取作业的当前状态。
  • 状态：pending（排队中）、running（处理中）、completed（成功完成）、failed（失败）。

• 列出所有作业

  • 端点：GET /api/scrape/jobs?page=1&limit=10
  • 功能：分页列出所有抓取作业。
  • 查询参数：page（页码）、limit（每页项目数）。

数据检索

• 获取 Instagram 用户数据

  • 端点：GET /api/scrape/data/user/:username
  • 功能：检索指定用户的资料数据。

• 获取 Instagram 帖子

  • 端点：GET /api/scrape/data/posts/:username?page=1&limit=20
  • 功能：分页检索指定用户的帖子数据。
  • 查询参数：page（页码）、limit（每页帖子数）。

• 获取缓存信息

  • 端点：GET /api/scrape/cache/:username
  • 功能：查询指定用户数据的缓存状态和新鲜度。

数据模型

Instagram 用户

包含字段：username（用户名）、instagramId（用户ID）、name（显示名称）、bio（个人简介）、followers（粉丝数）、follows（关注数）、is_private（隐私状态）、is_verified（验证状态）、profile_image（头像URL）、video_count（视频数）、image_count（图片数）。

Instagram 帖子

包含字段：shortcode（帖子短代码标识符）、username（用户名）、caption（帖子标题）、taken_at（Unix时间戳）、like_count（点赞数）、comment_count（评论数）、is_video（是否为视频）、media_url（媒体文件URL）、thumbnail_url（缩略图URL）、original_width（原始宽度）、original_height（原始高度）。

响应与错误码

• 200：成功
• 201：创建成功
• 202：已接受（作业已排队）
• 400：错误请求（验证错误）
• 401：未授权（令牌无效或缺失）
• 403：禁止（权限不足）
• 404：未找到
• 500：内部服务器错误

速率限制

API 遵守 Instagram 的速率限制（约每个 IP 200 次请求/小时）。作业会自动排队并处理，并带有适当的延迟以避免触发速率限制。

最佳实践建议

1. 令牌管理：安全存储令牌并在过期前刷新。
2. 作业轮询：每 2-5 秒轮询一次作业状态，而非连续轮询。
3. 错误处理：在获取数据前始终检查作业状态。
4. 分页：对于大型数据集（如帖子）使用分页。
5. 缓存：在启动新的抓取作业前检查缓存信息。
6. 速率限制：遵守 API 速率限制并相应地排队作业。