Social Media Scraping with StableSocial
Scrape profiles, posts, comments, followers, and search across 20+ platforms: TikTok, Instagram, YouTube, LinkedIn, X/Twitter, Facebook, Reddit, GitHub, Rumble, Threads, Bluesky, Pinterest, Twitch, Spotify, and more — plus ad libraries and a UGC research agent (Lightreel). All endpoints cost $0.06 per call.
Three endpoint families:
- Legacy platform endpoints (
/api/tiktok/*, /api/instagram/*, /api/facebook/*, /api/reddit/*) — profiles, posts, comments, followers, search
- Scrape Creators suite (
/api/sc/*) — much broader platform and data coverage, including transcripts, ad libraries, and niche platforms
- Lightreel UGC research agent (
/api/lightreel/*) — durable-job research tasks (hooks, trends, creator search, scripts, briefs)
Setup
See rules/getting-started.md for installation and wallet setup.
Notes
Use npx agentcash@latest fetch for paid POST triggers. Use npx agentcash@latest fetch for free GET polling.
IMPORTANT: Use exact endpoint paths from the Quick Reference tables below. All paths include a platform prefix (e.g. https://stablesocial.dev/api/tiktok/...).
How It Works: Async Two-Step Flow
Every request follows a trigger-then-poll pattern:
Step 1: Trigger (paid, $0.06)
npx agentcash@latest fetch https://stablesocial.dev/api/instagram/profile -m POST -b '{"handle": "natgeo"}'
Returns 202 Accepted with a durable job ID, poll URL, and legacy JWT token:
{"jobId": "abc123", "status": "pending", "pollUrl": "https://stablesocial.dev/api/jobs/abc123", "token": "eyJhbGciOiJIUzI1NiIs..."}
Step 2: Poll (free)
Poll the durable job by ID (requires SIWX wallet auth from the paying wallet — the agentcash CLI handles this automatically):
npx agentcash@latest fetch https://stablesocial.dev/api/jobs/abc123
Or poll with the legacy token (no wallet auth needed):
npx agentcash@latest fetch "https://stablesocial.dev/api/jobs?token=eyJhbGciOiJIUzI1NiIs..."
{"status": "pending"} — poll again in 3-5 seconds
{"status": "finished", "data": {...}} — data is ready
{"status": "failed", "error": "..."} — collection failed (not charged)
Tokens expire after 30 minutes; durable jobs remain pollable by jobId. Jobs typically finish in 5-60 seconds (Lightreel jobs can take longer). GET /api/jobs (no token) lists your durable jobs.
Quick Reference — TikTok
| Task |
Endpoint |
Depends On |
| Get profile |
https://stablesocial.dev/api/tiktok/profile |
— |
| Get posts |
https://stablesocial.dev/api/tiktok/posts |
profile |
| Post comments |
https://stablesocial.dev/api/tiktok/post-comments |
posts |
| Comment replies |
https://stablesocial.dev/api/tiktok/comment-replies |
post-comments |
| Followers |
https://stablesocial.dev/api/tiktok/followers |
profile |
| Following |
https://stablesocial.dev/api/tiktok/following |
profile |
| Search posts |
https://stablesocial.dev/api/tiktok/search |
— |
| Search hashtag |
https://stablesocial.dev/api/tiktok/search-hashtag |
— |
| Search profiles |
https://stablesocial.dev/api/tiktok/search-profiles |
— |
| Search by music |
https://stablesocial.dev/api/tiktok/search-music |
— |
Input: {"handle": "username"} for profile/posts/followers. {"query": "keyword"} for search.
Quick Reference — Instagram
| Task |
Endpoint |
Depends On |
| Get profile |
https://stablesocial.dev/api/instagram/profile |
— |
| Get posts |
https://stablesocial.dev/api/instagram/posts |
profile |
| Post comments |
https://stablesocial.dev/api/instagram/post-comments |
posts |
| Comment replies |
https://stablesocial.dev/api/instagram/comment-replies |
post-comments |
| Followers |
https://stablesocial.dev/api/instagram/followers |
profile |
| Following |
https://stablesocial.dev/api/instagram/following |
profile |
| Stories |
https://stablesocial.dev/api/instagram/stories |
profile |
| Highlights |
https://stablesocial.dev/api/instagram/highlights |
profile |
| Search posts |
https://stablesocial.dev/api/instagram/search |
— |
| Search tags |
https://stablesocial.dev/api/instagram/search-tags |
— |
Input: {"handle": "username"} for profile/posts/followers. {"query": "keyword"} for search.
Quick Reference — Facebook
| Task |
Endpoint |
Depends On |
| Get profile |
https://stablesocial.dev/api/facebook/profile |
— |
| Get posts |
https://stablesocial.dev/api/facebook/posts |
profile |
| Post comments |
https://stablesocial.dev/api/facebook/post-comments |
posts |
| Comment replies |
https://stablesocial.dev/api/facebook/comment-replies |
post-comments |
| Followers |
https://stablesocial.dev/api/facebook/followers |
profile |
| Following |
https://stablesocial.dev/api/facebook/following |
profile |
| Search posts |
https://stablesocial.dev/api/facebook/search |
— |
| Search people |
https://stablesocial.dev/api/facebook/search-people |
— |
| Search pages |
https://stablesocial.dev/api/facebook/search-pages |
— |
| Search groups |
https://stablesocial.dev/api/facebook/search-groups |
— |
Input: {"handle": "username"} or {"profile_id": "id"} for profile. {"query": "keyword"} for search.
Quick Reference — Reddit
| Task |
Endpoint |
Depends On |
| Get post |
https://stablesocial.dev/api/reddit/post |
— |
| Post comments |
https://stablesocial.dev/api/reddit/post-comments |
post |
| Get comment |
https://stablesocial.dev/api/reddit/comment |
— |
| Search posts |
https://stablesocial.dev/api/reddit/search |
— |
| Search profiles |
https://stablesocial.dev/api/reddit/search-profiles |
— |
| Subreddit posts |
https://stablesocial.dev/api/reddit/subreddit |
— |
Input: {"post_id": "id"} for post details. {"query": "keyword"} for search. {"subreddit": "name"} for subreddit.
Quick Reference — Scrape Creators Suite (/api/sc/*)
A larger, newer suite (~155 endpoints, all $0.06, same trigger-then-poll flow) covering many more platforms and data types. Coverage by platform:
| Platform |
Base path |
Coverage highlights |
| TikTok |
https://stablesocial.dev/api/sc/tiktok/... |
profile, videos, video transcripts, comments/replies, followers/following, audience demographics, search (users/hashtag/keyword/top), trending feed, popular creators/hashtags, songs, Shop products/reviews |
| Instagram |
https://stablesocial.dev/api/sc/instagram/... |
profile, posts, reels, post/reel info, media transcripts, comments, highlights, hashtag/profile/reels search, trending reels |
| YouTube |
https://stablesocial.dev/api/sc/youtube/... |
channel details/videos/playlists/lives/shorts/community posts, video details, transcripts, sponsors, comments/replies, search, trending shorts |
| LinkedIn |
https://stablesocial.dev/api/sc/linkedin/... |
person profile (pass a linkedin.com/in/... URL), company page/posts, post details/transcript, search posts, ads search/details |
| Facebook |
https://stablesocial.dev/api/sc/facebook/... |
profile, posts/reels/photos, post transcript, comments/replies, group posts, Ad Library (search/details/transcript/company ads), Marketplace (search/item/location), Events (search/details) |
| X/Twitter |
https://stablesocial.dev/api/sc/twitter/... |
profile, user tweets, tweet details/transcript, communities |
| Reddit |
https://stablesocial.dev/api/sc/reddit/... |
subreddit details/posts/search, post comments/transcript, search |
| GitHub |
https://stablesocial.dev/api/sc/github/... |
user, repositories, PRs, activity, followers/following, contributions, repository, trending repos/developers |
| Rumble |
https://stablesocial.dev/api/sc/rumble/... |
search, channel videos, video, transcript, comments |
| Ad libraries |
.../api/sc/tiktok/ad-library/..., .../api/sc/google/..., .../api/sc/linkedin/ads/... |
TikTok Ad Library search/ad, Google company ads/ad details/advertiser search, LinkedIn ads |
| Others |
https://stablesocial.dev/api/sc/... |
Truth Social, Threads, Bluesky, Pinterest, Twitch, Spotify, SoundCloud, Kwai, Kick, Snapchat, Google Search, Amazon Shop, link-in-bio pages (Linktree, Komi, Pillar, Linkbio, Linkme), age/gender detection |
Representative examples:
npx agentcash@latest fetch https://stablesocial.dev/api/sc/tiktok/profile -m POST -b '{"handle": "username"}'
npx agentcash@latest fetch https://stablesocial.dev/api/sc/youtube/video/transcript -m POST -b '{"url": "https://youtube.com/watch?v=..."}'
npx agentcash@latest fetch https://stablesocial.dev/api/sc/linkedin/profile -m POST -b '{"url": "https://linkedin.com/in/someone"}'
npx agentcash@latest fetch https://stablesocial.dev/api/sc/facebook/adLibrary/search/ads -m POST -b '{"query": "brand name"}'
Input: varies per endpoint — many accept {"handle": ...} or an ID, some accept a full {"url": ...} (e.g. LinkedIn profile). Check the endpoint schema (npx agentcash@latest discover https://stablesocial.dev) when unsure.
Quick Reference — Lightreel UGC Research Agent (/api/lightreel/*)
An AI research agent for UGC/short-form content. All $0.06 per call; returns a durable job immediately — poll GET /api/jobs/{jobId}. Jobs are research tasks and can take minutes, not seconds.
| Task |
Endpoint |
| Ask the agent anything |
https://stablesocial.dev/api/lightreel/chat |
| Top-performing hooks |
https://stablesocial.dev/api/lightreel/top-hooks |
| UGC video search |
https://stablesocial.dev/api/lightreel/video-search |
| Creator search (incl. contact info) |
https://stablesocial.dev/api/lightreel/creator-search |
| Content trends |
https://stablesocial.dev/api/lightreel/trends |
| Account audit/feedback |
https://stablesocial.dev/api/lightreel/account-feedback |
| Competitor strategy |
https://stablesocial.dev/api/lightreel/competitor-strategy |
| Script ideas |
https://stablesocial.dev/api/lightreel/script-ideas |
| Video ideas |
https://stablesocial.dev/api/lightreel/video-ideas |
| Video/draft feedback |
https://stablesocial.dev/api/lightreel/video-feedback |
| UGC brief |
https://stablesocial.dev/api/lightreel/ugc-brief |
| Content calendar |
https://stablesocial.dev/api/lightreel/content-calendar |
| Brand mentions |
https://stablesocial.dev/api/lightreel/brand-mentions |
| Creator performance |
https://stablesocial.dev/api/lightreel/creator-performance |
Input: /chat takes {"question": "..."} (required), optional conversation_id to continue a conversation and response_fields (up to 5 fields, type string or array) for structured output. Task endpoints take task-specific fields — e.g. /top-hooks takes {"topic": "..."} (required) plus optional timeframe, platform, max_hooks, conversation_id.
npx agentcash@latest fetch https://stablesocial.dev/api/lightreel/top-hooks -m POST -b '{"topic": "skincare UGC ads"}'
Free SIWX-authed extras: GET /api/lightreel/chats lists your Lightreel chats; GET /api/lightreel/chat/{conversationId} fetches a transcript (must be the wallet that paid).
Data Dependencies
Some endpoints require a prior collection. For example, to get followers you must first trigger the profile:
# 1. Trigger profile collection
npx agentcash@latest fetch https://stablesocial.dev/api/instagram/profile -m POST -b '{"handle": "natgeo"}'
# Poll until finished...
# 2. Now fetch followers (depends on profile)
npx agentcash@latest fetch https://stablesocial.dev/api/instagram/followers -m POST -b '{"handle": "natgeo"}'
# Poll until finished...
Pagination
When results are paginated, the response includes page_info.has_next_page and a cursor. Pass the cursor to fetch the next page (each page is a new paid POST):
npx agentcash@latest fetch https://stablesocial.dev/api/tiktok/followers -m POST -b '{"handle": "username", "cursor": "abc123"}'
Key Parameters
handle / profile_id — target account
max_page_size — results per page (default varies, max 100)
max_followers — how many followers to collect (default 500)
max_posts / max_results — item limits (default 50)
cursor — pagination cursor from previous response
order_by — sort order: date_desc, date_asc, id_desc
Workflows
Profile Deep Dive
Cross-Platform Search
npx agentcash@latest fetch https://stablesocial.dev/api/instagram/search -m POST -b '{"query": "brand name"}'
npx agentcash@latest fetch https://stablesocial.dev/api/tiktok/search -m POST -b '{"query": "brand name"}'
npx agentcash@latest fetch https://stablesocial.dev/api/reddit/search -m POST -b '{"query": "brand name"}'
Influencer Analysis
Competitive Intelligence
npx agentcash@latest fetch https://stablesocial.dev/api/instagram/profile -m POST -b '{"handle": "competitor"}'
npx agentcash@latest fetch https://stablesocial.dev/api/reddit/search -m POST -b '{"query": "competitor name"}'
Cost Estimation
All endpoints are $0.06 per trigger call. Polling is free.
| Task |
Calls |
Cost |
| Single profile |
1 |
$0.06 |
| Profile + posts |
2 |
$0.12 |
| Full profile deep dive |
4-6 |
$0.24-0.36 |
| Cross-platform search (3 platforms) |
3 |
$0.18 |
| Competitor analysis |
4-8 |
$0.24-0.48 |
vs social-intelligence Skill
The social-intelligence skill uses Reddit (stableenrich.dev). Use it for quick Reddit post lookups and discussions.
Use social-scraping (this skill) when you need:
- TikTok, Instagram, YouTube, LinkedIn, X/Twitter, Facebook, Reddit, GitHub, or other platform data (beyond basic Reddit search)
- Profiles, followers, following — not just search
- Comments, replies, reactions, transcripts on posts and videos
- Ad libraries, Marketplace, Events data
- UGC research (hooks, trends, creators, scripts) via Lightreel
- Cross-platform research
1---2name: social-scraping3description: |4 Scrape social media profiles, posts, comments, followers, and search across 20+ platforms via x402.56 USE FOR:7 - Getting TikTok, Instagram, YouTube, LinkedIn, X/Twitter, Facebook, or Reddit profiles8 - Fetching a user's posts, stories, highlights, videos, or transcripts9 - Getting comments, replies, and reactions on posts10 - Listing followers and following for any account11 - Searching posts, hashtags, and profiles across platforms12 - Scraping ad libraries (Facebook, TikTok, Google, LinkedIn), Facebook Marketplace, Events, and Groups13 - GitHub users, repos, and trending; Rumble, Threads, Bluesky, Pinterest, Twitch, Spotify, and more14 - UGC research via the Lightreel agent: hooks, trends, creator search, scripts, briefs15 - Cross-platform social media research and monitoring1617 TRIGGERS:18 - "tiktok", "instagram", "facebook", "reddit", "youtube", "linkedin", "twitter"19 - "get followers", "who follows", "following list"20 - "scrape profile", "get posts from", "social media data"21 - "instagram stories", "tiktok videos", "facebook page", "youtube channel"22 - "ad library", "facebook ads", "tiktok ads", "marketplace"23 - "ugc", "hooks", "creator search", "content trends"24 - "cross-platform", "social media research"2526 IMPORTANT: StableSocial uses an async two-step flow. Step 1: POST triggers data collection (paid, $0.06). Step 2: Poll GET /api/jobs/{jobId} (or legacy GET /api/jobs?token=...) until finished (free). All endpoints are $0.06 per call.27metadata:28 source: https://skillmd.com/skills/merit-systems/social-scraping29 version: 230---3132# Social Media Scraping with StableSocial3334Scrape profiles, posts, comments, followers, and search across 20+ platforms: TikTok, Instagram, YouTube, LinkedIn, X/Twitter, Facebook, Reddit, GitHub, Rumble, Threads, Bluesky, Pinterest, Twitch, Spotify, and more — plus ad libraries and a UGC research agent (Lightreel). All endpoints cost $0.06 per call.3536Three endpoint families:37- **Legacy platform endpoints** (`/api/tiktok/*`, `/api/instagram/*`, `/api/facebook/*`, `/api/reddit/*`) — profiles, posts, comments, followers, search38- **Scrape Creators suite** (`/api/sc/*`) — much broader platform and data coverage, including transcripts, ad libraries, and niche platforms39- **Lightreel UGC research agent** (`/api/lightreel/*`) — durable-job research tasks (hooks, trends, creator search, scripts, briefs)4041## Setup4243See [rules/getting-started.md](rules/getting-started.md) for installation and wallet setup.4445## Notes46Use `npx agentcash@latest fetch` for paid POST triggers. Use `npx agentcash@latest fetch` for free GET polling.4748IMPORTANT: Use exact endpoint paths from the Quick Reference tables below. All paths include a platform prefix (e.g. `https://stablesocial.dev/api/tiktok/...`).4950## How It Works: Async Two-Step Flow5152Every request follows a **trigger-then-poll** pattern:5354### Step 1: Trigger (paid, $0.06)5556```bash57npx agentcash@latest fetch https://stablesocial.dev/api/instagram/profile -m POST -b '{"handle": "natgeo"}'58```5960Returns `202 Accepted` with a durable job ID, poll URL, and legacy JWT token:61```json62{"jobId": "abc123", "status": "pending", "pollUrl": "https://stablesocial.dev/api/jobs/abc123", "token": "eyJhbGciOiJIUzI1NiIs..."}63```6465### Step 2: Poll (free)6667Poll the durable job by ID (requires SIWX wallet auth from the paying wallet — the agentcash CLI handles this automatically):6869```bash70npx agentcash@latest fetch https://stablesocial.dev/api/jobs/abc12371```7273Or poll with the legacy token (no wallet auth needed):7475```bash76npx agentcash@latest fetch "https://stablesocial.dev/api/jobs?token=eyJhbGciOiJIUzI1NiIs..."77```7879- `{"status": "pending"}` — poll again in 3-5 seconds80- `{"status": "finished", "data": {...}}` — data is ready81- `{"status": "failed", "error": "..."}` — collection failed (not charged)8283Tokens expire after 30 minutes; durable jobs remain pollable by jobId. Jobs typically finish in 5-60 seconds (Lightreel jobs can take longer). `GET /api/jobs` (no token) lists your durable jobs.8485## Quick Reference — TikTok8687| Task | Endpoint | Depends On |88|------|----------|------------|89| Get profile | `https://stablesocial.dev/api/tiktok/profile` | — |90| Get posts | `https://stablesocial.dev/api/tiktok/posts` | profile |91| Post comments | `https://stablesocial.dev/api/tiktok/post-comments` | posts |92| Comment replies | `https://stablesocial.dev/api/tiktok/comment-replies` | post-comments |93| Followers | `https://stablesocial.dev/api/tiktok/followers` | profile |94| Following | `https://stablesocial.dev/api/tiktok/following` | profile |95| Search posts | `https://stablesocial.dev/api/tiktok/search` | — |96| Search hashtag | `https://stablesocial.dev/api/tiktok/search-hashtag` | — |97| Search profiles | `https://stablesocial.dev/api/tiktok/search-profiles` | — |98| Search by music | `https://stablesocial.dev/api/tiktok/search-music` | — |99100**Input:** `{"handle": "username"}` for profile/posts/followers. `{"query": "keyword"}` for search.101102## Quick Reference — Instagram103104| Task | Endpoint | Depends On |105|------|----------|------------|106| Get profile | `https://stablesocial.dev/api/instagram/profile` | — |107| Get posts | `https://stablesocial.dev/api/instagram/posts` | profile |108| Post comments | `https://stablesocial.dev/api/instagram/post-comments` | posts |109| Comment replies | `https://stablesocial.dev/api/instagram/comment-replies` | post-comments |110| Followers | `https://stablesocial.dev/api/instagram/followers` | profile |111| Following | `https://stablesocial.dev/api/instagram/following` | profile |112| Stories | `https://stablesocial.dev/api/instagram/stories` | profile |113| Highlights | `https://stablesocial.dev/api/instagram/highlights` | profile |114| Search posts | `https://stablesocial.dev/api/instagram/search` | — |115| Search tags | `https://stablesocial.dev/api/instagram/search-tags` | — |116117**Input:** `{"handle": "username"}` for profile/posts/followers. `{"query": "keyword"}` for search.118119## Quick Reference — Facebook120121| Task | Endpoint | Depends On |122|------|----------|------------|123| Get profile | `https://stablesocial.dev/api/facebook/profile` | — |124| Get posts | `https://stablesocial.dev/api/facebook/posts` | profile |125| Post comments | `https://stablesocial.dev/api/facebook/post-comments` | posts |126| Comment replies | `https://stablesocial.dev/api/facebook/comment-replies` | post-comments |127| Followers | `https://stablesocial.dev/api/facebook/followers` | profile |128| Following | `https://stablesocial.dev/api/facebook/following` | profile |129| Search posts | `https://stablesocial.dev/api/facebook/search` | — |130| Search people | `https://stablesocial.dev/api/facebook/search-people` | — |131| Search pages | `https://stablesocial.dev/api/facebook/search-pages` | — |132| Search groups | `https://stablesocial.dev/api/facebook/search-groups` | — |133134**Input:** `{"handle": "username"}` or `{"profile_id": "id"}` for profile. `{"query": "keyword"}` for search.135136## Quick Reference — Reddit137138| Task | Endpoint | Depends On |139|------|----------|------------|140| Get post | `https://stablesocial.dev/api/reddit/post` | — |141| Post comments | `https://stablesocial.dev/api/reddit/post-comments` | post |142| Get comment | `https://stablesocial.dev/api/reddit/comment` | — |143| Search posts | `https://stablesocial.dev/api/reddit/search` | — |144| Search profiles | `https://stablesocial.dev/api/reddit/search-profiles` | — |145| Subreddit posts | `https://stablesocial.dev/api/reddit/subreddit` | — |146147**Input:** `{"post_id": "id"}` for post details. `{"query": "keyword"}` for search. `{"subreddit": "name"}` for subreddit.148149## Quick Reference — Scrape Creators Suite (`/api/sc/*`)150151A larger, newer suite (~155 endpoints, all $0.06, same trigger-then-poll flow) covering many more platforms and data types. Coverage by platform:152153| Platform | Base path | Coverage highlights |154|----------|-----------|---------------------|155| TikTok | `https://stablesocial.dev/api/sc/tiktok/...` | profile, videos, video transcripts, comments/replies, followers/following, audience demographics, search (users/hashtag/keyword/top), trending feed, popular creators/hashtags, songs, Shop products/reviews |156| Instagram | `https://stablesocial.dev/api/sc/instagram/...` | profile, posts, reels, post/reel info, media transcripts, comments, highlights, hashtag/profile/reels search, trending reels |157| YouTube | `https://stablesocial.dev/api/sc/youtube/...` | channel details/videos/playlists/lives/shorts/community posts, video details, transcripts, sponsors, comments/replies, search, trending shorts |158| LinkedIn | `https://stablesocial.dev/api/sc/linkedin/...` | person profile (pass a linkedin.com/in/... URL), company page/posts, post details/transcript, search posts, ads search/details |159| Facebook | `https://stablesocial.dev/api/sc/facebook/...` | profile, posts/reels/photos, post transcript, comments/replies, group posts, Ad Library (search/details/transcript/company ads), Marketplace (search/item/location), Events (search/details) |160| X/Twitter | `https://stablesocial.dev/api/sc/twitter/...` | profile, user tweets, tweet details/transcript, communities |161| Reddit | `https://stablesocial.dev/api/sc/reddit/...` | subreddit details/posts/search, post comments/transcript, search |162| GitHub | `https://stablesocial.dev/api/sc/github/...` | user, repositories, PRs, activity, followers/following, contributions, repository, trending repos/developers |163| Rumble | `https://stablesocial.dev/api/sc/rumble/...` | search, channel videos, video, transcript, comments |164| Ad libraries | `.../api/sc/tiktok/ad-library/...`, `.../api/sc/google/...`, `.../api/sc/linkedin/ads/...` | TikTok Ad Library search/ad, Google company ads/ad details/advertiser search, LinkedIn ads |165| Others | `https://stablesocial.dev/api/sc/...` | Truth Social, Threads, Bluesky, Pinterest, Twitch, Spotify, SoundCloud, Kwai, Kick, Snapchat, Google Search, Amazon Shop, link-in-bio pages (Linktree, Komi, Pillar, Linkbio, Linkme), age/gender detection |166167Representative examples:168169```bash170npx agentcash@latest fetch https://stablesocial.dev/api/sc/tiktok/profile -m POST -b '{"handle": "username"}'171npx agentcash@latest fetch https://stablesocial.dev/api/sc/youtube/video/transcript -m POST -b '{"url": "https://youtube.com/watch?v=..."}'172npx agentcash@latest fetch https://stablesocial.dev/api/sc/linkedin/profile -m POST -b '{"url": "https://linkedin.com/in/someone"}'173npx agentcash@latest fetch https://stablesocial.dev/api/sc/facebook/adLibrary/search/ads -m POST -b '{"query": "brand name"}'174```175176**Input:** varies per endpoint — many accept `{"handle": ...}` or an ID, some accept a full `{"url": ...}` (e.g. LinkedIn profile). Check the endpoint schema (`npx agentcash@latest discover https://stablesocial.dev`) when unsure.177178## Quick Reference — Lightreel UGC Research Agent (`/api/lightreel/*`)179180An AI research agent for UGC/short-form content. All $0.06 per call; returns a durable job immediately — poll `GET /api/jobs/{jobId}`. Jobs are research tasks and can take minutes, not seconds.181182| Task | Endpoint |183|------|----------|184| Ask the agent anything | `https://stablesocial.dev/api/lightreel/chat` |185| Top-performing hooks | `https://stablesocial.dev/api/lightreel/top-hooks` |186| UGC video search | `https://stablesocial.dev/api/lightreel/video-search` |187| Creator search (incl. contact info) | `https://stablesocial.dev/api/lightreel/creator-search` |188| Content trends | `https://stablesocial.dev/api/lightreel/trends` |189| Account audit/feedback | `https://stablesocial.dev/api/lightreel/account-feedback` |190| Competitor strategy | `https://stablesocial.dev/api/lightreel/competitor-strategy` |191| Script ideas | `https://stablesocial.dev/api/lightreel/script-ideas` |192| Video ideas | `https://stablesocial.dev/api/lightreel/video-ideas` |193| Video/draft feedback | `https://stablesocial.dev/api/lightreel/video-feedback` |194| UGC brief | `https://stablesocial.dev/api/lightreel/ugc-brief` |195| Content calendar | `https://stablesocial.dev/api/lightreel/content-calendar` |196| Brand mentions | `https://stablesocial.dev/api/lightreel/brand-mentions` |197| Creator performance | `https://stablesocial.dev/api/lightreel/creator-performance` |198199**Input:** `/chat` takes `{"question": "..."}` (required), optional `conversation_id` to continue a conversation and `response_fields` (up to 5 fields, type `string` or `array`) for structured output. Task endpoints take task-specific fields — e.g. `/top-hooks` takes `{"topic": "..."}` (required) plus optional `timeframe`, `platform`, `max_hooks`, `conversation_id`.200201```bash202npx agentcash@latest fetch https://stablesocial.dev/api/lightreel/top-hooks -m POST -b '{"topic": "skincare UGC ads"}'203```204205Free SIWX-authed extras: `GET /api/lightreel/chats` lists your Lightreel chats; `GET /api/lightreel/chat/{conversationId}` fetches a transcript (must be the wallet that paid).206207## Data Dependencies208209Some endpoints require a prior collection. For example, to get followers you must first trigger the profile:210211```bash212# 1. Trigger profile collection213npx agentcash@latest fetch https://stablesocial.dev/api/instagram/profile -m POST -b '{"handle": "natgeo"}'214# Poll until finished...215216# 2. Now fetch followers (depends on profile)217npx agentcash@latest fetch https://stablesocial.dev/api/instagram/followers -m POST -b '{"handle": "natgeo"}'218# Poll until finished...219```220221## Pagination222223When results are paginated, the response includes `page_info.has_next_page` and a `cursor`. Pass the cursor to fetch the next page (each page is a new paid POST):224225```bash226npx agentcash@latest fetch https://stablesocial.dev/api/tiktok/followers -m POST -b '{"handle": "username", "cursor": "abc123"}'227```228229## Key Parameters230231- `handle` / `profile_id` — target account232- `max_page_size` — results per page (default varies, max 100)233- `max_followers` — how many followers to collect (default 500)234- `max_posts` / `max_results` — item limits (default 50)235- `cursor` — pagination cursor from previous response236- `order_by` — sort order: `date_desc`, `date_asc`, `id_desc`237238## Workflows239240### Profile Deep Dive241242- [ ] (Optional) Check balance: `npx agentcash@latest balance`243- [ ] Trigger profile collection244- [ ] Poll until finished245- [ ] Trigger posts collection246- [ ] Poll until finished247- [ ] Optionally fetch comments, followers248249### Cross-Platform Search250251- [ ] Search same keyword across multiple platforms252- [ ] Compare results and synthesize findings253254```bash255npx agentcash@latest fetch https://stablesocial.dev/api/instagram/search -m POST -b '{"query": "brand name"}'256npx agentcash@latest fetch https://stablesocial.dev/api/tiktok/search -m POST -b '{"query": "brand name"}'257npx agentcash@latest fetch https://stablesocial.dev/api/reddit/search -m POST -b '{"query": "brand name"}'258```259260### Influencer Analysis261262- [ ] Get profile on target platform263- [ ] Fetch recent posts with engagement264- [ ] Get follower list for audience analysis265- [ ] Check comments for sentiment266267### Competitive Intelligence268269- [ ] Search for competitor on target platform270- [ ] Get competitor posts and engagement271- [ ] Monitor competitor mentions across platforms272- [ ] Analyze audience sentiment via comments273274```bash275npx agentcash@latest fetch https://stablesocial.dev/api/instagram/profile -m POST -b '{"handle": "competitor"}'276npx agentcash@latest fetch https://stablesocial.dev/api/reddit/search -m POST -b '{"query": "competitor name"}'277```278279## Cost Estimation280281All endpoints are $0.06 per trigger call. Polling is free.282283| Task | Calls | Cost |284|------|-------|------|285| Single profile | 1 | $0.06 |286| Profile + posts | 2 | $0.12 |287| Full profile deep dive | 4-6 | $0.24-0.36 |288| Cross-platform search (3 platforms) | 3 | $0.18 |289| Competitor analysis | 4-8 | $0.24-0.48 |290291## vs social-intelligence Skill292293The `social-intelligence` skill uses Reddit (stableenrich.dev). Use it for quick Reddit post lookups and discussions.294295Use `social-scraping` (this skill) when you need:296- **TikTok, Instagram, YouTube, LinkedIn, X/Twitter, Facebook, Reddit, GitHub, or other platform** data (beyond basic Reddit search)297- **Profiles, followers, following** — not just search298- **Comments, replies, reactions, transcripts** on posts and videos299- **Ad libraries, Marketplace, Events** data300- **UGC research** (hooks, trends, creators, scripts) via Lightreel301- **Cross-platform** research