facebook-scraper-api
Pull a Facebook page's profile, posts, reels and photos, one post with its comments, a single reel/video with downloadable URLs, a public group and its posts, an event, and hashtag posts. 11 endpoints, 1 credit each, structured JSON.
scavio-ai · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add scavio-ai/skills --skill facebook-scraper-api技能说明
name: facebook-scraper-api description: Pull a Facebook page's profile, posts, reels and photos, one post with its comments, a single reel/video with downloadable URLs, a public group and its posts, an event, and hashtag posts. 11 endpoints, 1 credit each, structured JSON. version: 1.0.0 tags: facebook, facebook-api, social-media-data, page-data, posts, reels, comments, groups, events, hashtags, video-download, brand-monitoring, influencer-data, agents, structured-data, json, ai-agents, scraping-api metadata: openclaw: requires: env: - SCAVIO_API_KEY primaryEnv: SCAVIO_API_KEY timeout: 120 throttle: 1 emoji: "\U0001F44D" homepage: https://scavio.dev/docs?utm_source=agent-skills&utm_medium=skill&utm_campaign=facebook-scraper-api
Facebook API - Pages, Posts, Reels, Groups, Events
Pull a Facebook page's profile, posts, reels and photos, one post with its comments, a single reel or video with downloadable URLs, a public group and its posts, an event, and the top posts for a hashtag. All endpoints return structured JSON.
When to trigger
Use this skill when the user asks to:
- Read a Facebook page or public profile: name, category, verified flag, likes, followers, and (where published) website, phone, email, address, hours, rating, profile and cover photos
- Read a page's recent top posts, its reels (with downloadable video URLs), or its photo grid
- Read one post in full with its reaction breakdown and top comments
- Resolve a reel / video / watch item to its downloadable HD and SD video URLs
- Read a public group's profile and its top posts
- Read a public event (time, location, host, going/interested counts)
- Read the top public posts for a hashtag
- Do brand monitoring, competitor page analysis or content research on Facebook
Setup
Get a free API key at scavio.dev (50 free credits to get started, no card required):
export SCAVIO_API_KEY=sk_live_your_key
If you do not have a key yet
An agent running this skill without SCAVIO_API_KEY set will get 401 on every
call below. The whole path from nothing to a working key is self-serve:
- Sign up at dashboard.scavio.dev - email or Google, no card required.
- A key is created for the account automatically at signup. It is on the dashboard under API Keys, ready to copy.
- A new account starts with 50 credits. Endpoints in this skill cost 1 credit each unless the table below says otherwise.
When the balance runs out the API answers 402 with a JSON body carrying
billing_url. Topping up needs no code change - the same key keeps working.
The smallest purchase is 2,500 credits for $25, and monthly plans work out
cheaper per credit if the usage is steady rather than one-off.
Every request is a POST with a JSON body and:
Authorization: Bearer $SCAVIO_API_KEY
Endpoints
Base URL: https://api.scavio.dev. Every Facebook endpoint costs 1 credit.
| Endpoint | Credits | What it returns |
|---|---|---|
POST /api/v1/facebook/profile | 1 | A page or public profile: name, category, verified flag, likes, followers, talking-about and were-here counts, bio, and where published website/phone/email/address/hours/rating/screenname/creation date/profile+cover photo |
POST /api/v1/facebook/profile/posts | 1 | A page's most recent top posts: text, timestamp, reaction total and breakdown, comment and share counts, media, permalink |
POST /api/v1/facebook/profile/reels | 1 | A page's reels: id, url, downloadable video URLs, thumbnail, duration, play count, owner id |
POST /api/v1/facebook/profile/photos | 1 | A page's photo grid: photo id, image URL, accessibility caption |
POST /api/v1/facebook/post | 1 | One post in full: author, text, timestamp, reaction breakdown, comment and share counts, top comments, media, permalink |
POST /api/v1/facebook/post/comments | 1 | The top visible comments on a post: id, author, text, reaction count, time |
POST /api/v1/facebook/reel | 1 | One reel/video/watch item: title, description, downloadable HD and SD video URLs, thumbnail, duration, view/play counts, reactions, comments, shares, owner, permalink |
POST /api/v1/facebook/group | 1 | A public group's profile: id, name, visibility, member count, description, privacy |
POST /api/v1/facebook/group/posts | 1 | The top posts in a public group: author, text, timestamp, reactions, comment and share counts, media, permalink |
POST /api/v1/facebook/event | 1 | A public event: name, description, start/end time, location, host, going and interested counts, cover photo |
POST /api/v1/facebook/hashtag | 1 | The top public posts for a hashtag: author, text, timestamp, reactions, media, permalink |
Parameters
Every endpoint except hashtag takes a single url:
| Parameter | Type | Description |
|---|---|---|
url | string | A Facebook URL for the requested surface - a page/profile, post permalink, reel/video, group, or event. profile and group also accept a bare page id / group id |
hashtag takes:
| Parameter | Type | Description |
|---|---|---|
tag | string | A hashtag name, with or without the leading # |
Scope notes
- The post and group-post endpoints return the current top posts, not the full historical feed.
post/commentsreturns the top visible comments, not the full thread or nested replies.- Private groups and locked profiles are reported as unavailable (a
404), and cost nothing. - Reel and video URLs are directly downloadable but signed with a short expiry - use them promptly.
Examples
import requests
BASE = "https://api.scavio.dev"
# Your key from https://scavio.dev. Load it from your environment or secret
# store in real code - keep it out of source control.
A
阅读完整来源 ↗