Scrapesocial Facebook
Use this skill for Facebook research and analysis tasks. It maps the user's goal to the right scrapesocial Facebook command.
Prerequisites
- A Scrape Creators API key is required for this skill. Get one at scrapecreators.com.
Quick start
- Install the CLI once:
npm install -g scrapesocial- Ensure authentication is available through
SCRAPECREATORS_API_KEYor--api-key. - Start from the most stable identifier you have:
- A page/profile URL for organic Facebook data - A post URL for a single post, transcript, or comment thread - A group URL for community research - A brand name, keyword, page ID, or ad ID for Ad Library work
- Prefer a narrow command first, then paginate or deepen only when needed.
Goal-led workflows
| Goal | When to use this skill | How to start |
|---|---|---|
| Lead generation | Use it to qualify known brands, pages, advertisers, or community-led prospects. It is better for qualification than cold discovery. | Start with facebook ads companies search for known brands or facebook profiles get for known pages, then expand with facebook profiles posts or facebook ads companies get. |
| Influencer discovery | Use it to vet known creators or pages surfaced elsewhere and see whether they publish consistently in the niche. | Start with facebook profiles get, then compare facebook profiles reels and facebook profiles posts. |
| Brand monitoring | Use it to watch owned pages, groups, and ad activity over time. | Start with facebook profiles posts, facebook profiles reels, facebook groups posts, or facebook ads companies get, depending on the surface. |
| Competitor analysis | Use it to compare page activity, creative formats, and paid messaging across competitors. | Start with facebook profiles get for each page, then use facebook profiles posts and facebook ads companies get for side-by-side review. |
| Content analytics | Use it to explain which posts, reels, photos, or ads deserve deeper analysis. | Start with facebook profiles posts or facebook profiles reels, then inspect winners with facebook posts get, facebook comments, or facebook transcript. |
| Trend research | Use it for group conversations and ad-library pattern spotting. | Start with facebook groups posts for discussion trends or facebook ads search for creative and message trends. |
| Audience analysis | Use it for qualitative audience language, objections, and reactions. It does not provide demographic audience breakdowns. | Start with facebook comments on representative posts or facebook groups posts for community discussion. |
Choose the right command
scrapesocial facebook profiles get
- Use for page/profile metadata. - Good first step for business pages; add --get-business-hours when hours matter.
scrapesocial facebook profiles posts
- Use to collect recent timeline posts from a page or profile. - Good for content audits, engagement review, and finding post URLs to inspect further.
scrapesocial facebook profiles reels
- Use to collect a page's reels feed. - Good for short-form creative research and video content tracking.
scrapesocial facebook profiles photos
- Use to collect a page's photo feed. - Good for image creative analysis and gallery extraction.
scrapesocial facebook posts get
- Use for one post or reel when you need the full object. - Add --get-comments or --get-transcript when you want an initial deep dive in one request.
scrapesocial facebook comments
- Use to paginate through a post or reel's comments. - Prefer --feedback-id when available; get it from facebook posts get.
scrapesocial facebook transcript
- Use when you only need the transcript for a post and do not need the rest of the post payload.
scrapesocial facebook groups posts
- Use to pull posts from a Facebook group. - Good for community monitoring, topic discovery, and trend spotting.
scrapesocial facebook ads search
- Use to search the Meta Ad Library by keyword or theme. - Best for market scans, messaging research, and finding ads before you know the advertiser.
scrapesocial facebook ads companies search
- Use to find advertiser identities and page IDs from a company or brand name. - Best first step when the user says "show me this brand's Facebook ads."
scrapesocial facebook ads companies get
- Use to list ads for a known advertiser. - Best when you already have the page ID or have just looked it up.
scrapesocial facebook ads get
- Use to inspect one specific ad in detail. - Add --get-transcript for short video ads when transcript text matters.
Common workflows
Page or profile audit
- Run
facebook profiles getto confirm the page and collect top-level metadata. - Run
facebook profiles postsfor the timeline. - Add
facebook profiles reelsandfacebook profiles photosif the user wants a fuller creative inventory. - Open individual posts with
facebook posts getwhen deeper analysis is needed.
Post investigation
- Start with
facebook posts get --url.... - If you need the first comments or transcript immediately, add
--get-commentsand/or--get-transcript. - If the thread is long, continue with
facebook comments, reusing--feedback-idfrom the post payload when available.
Group research
- Use
facebook groups posts --url.... - Adjust
--sort-bybased on the task:
- TOP_POSTS for what performs best - RECENT_ACTIVITY or CHRONOLOGICAL for monitoring current discussions
- Keep paginating with
--cursoruntil you have enough coverage.
Ad research
- If you know the message or market but not the advertiser, start with
facebook ads search. - If you know the brand, start with
facebook ads companies search, then move tofacebook ads companies get. - Use
facebook ads geton standout ads for creative details or transcripts. - Apply filters like country, status, media type, and date range before paginating widely.
Working notes
- Many Facebook listing commands return pagination data. Reuse
--cursor,--page-id, or--group-idexactly as returned. facebook commentsis much faster with--feedback-idthan with only a post URL.facebook ads searchis best for theme-based discovery.facebook ads companies getis best for advertiser-level collection.- Use
--trimon ad commands when you want leaner payloads for downstream processing.
Minimal examples
scrapesocial facebook profiles get --url https://www.facebook.com/nasa
scrapesocial facebook profiles posts --url https://www.facebook.com/nasa
scrapesocial facebook posts get --url https://www.facebook.com/... --get-comments --get-transcript
scrapesocial facebook groups posts --url https://www.facebook.com/groups/...
scrapesocial facebook ads companies search --query "Nike"
scrapesocial facebook ads companies get --page-id 123456789
scrapesocial facebook ads search --query "running shoes" --country US --status ACTIVE
scrapesocial facebook ads get --id 1234567890 --get-transcript