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_KEY or --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

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

1. Run facebook profiles get to confirm the page and collect top-level metadata.
2. Run facebook profiles posts for the timeline.
3. Add facebook profiles reels and facebook profiles photos if the user wants a fuller creative inventory.
4. Open individual posts with facebook posts get when deeper analysis is needed.

Post investigation

1. Start with facebook posts get --url ....
2. If you need the first comments or transcript immediately, add --get-comments and/or --get-transcript.
3. If the thread is long, continue with facebook comments, reusing --feedback-id from the post payload when available.

Group research

1. Use facebook groups posts --url ....
2. Adjust --sort-by based on the task:
   • TOP_POSTS for what performs best
   • RECENT_ACTIVITY or CHRONOLOGICAL for monitoring current discussions
3. Keep paginating with --cursor until you have enough coverage.

Ad research

1. If you know the message or market but not the advertiser, start with facebook ads search.
2. If you know the brand, start with facebook ads companies search, then move to facebook ads companies get.
3. Use facebook ads get on standout ads for creative details or transcripts.
4. 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-id exactly as returned.
• facebook comments is much faster with --feedback-id than with only a post URL.
• facebook ads search is best for theme-based discovery. facebook ads companies get is best for advertiser-level collection.
• Use --trim on 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