Provider reference for collecting public profiles, posts, comments, transcripts, trends, and ad-library data from major social platforms through ScrapeCreators. Use as a dependency of research workflows, not as the final user-facing deliverable.
Install gooseworks: https://gooseworks.ai/creative-agent/install.md # then, in Claude Code, Cursor, or Codex: /gooseworks use the scrapecreators-api skill
Use ScrapeCreators when a workflow needs structured public social or ad-library data at a scale that ordinary web search cannot provide.
Task skills describe each request as an environment-neutral operation containing provider, method, path, and optional query or body. Execute that same operation through the first available runtime:
data_call_provider tool. Pass the operation fields directly. This is the preferred path in ChatGPT, Cowork, and any client without a terminal. It uses the first-party GooseWorks ScrapeCreators proxy and managed key; it does not route through Orthogonal.gooseworks call <provider> <path>, adding the method, query, or body options represented in the operation. The CLI uses the same first-party proxy.https://api.scrapecreators.com<path> with SCRAPECREATORS_API_KEY in the x-api-key header, using the operation's method, query, and JSON body.Prefer MCP whenever data_call_provider is registered, even if a shell might also exist. Never ask for a separate provider key when the managed MCP or CLI path is available. Never print, store, or return either credential.
Example operation:
provider: scrapecreators
method: GET
path: /v1/instagram/profile
query:
handle: brandUse ScrapeCreators' official OpenAPI as the endpoint source of truth: https://docs.scrapecreators.com/openapi.json. Do not use Orthogonal search or details to discover ScrapeCreators operations because its mirrored catalog can be incomplete.
| Need | Common endpoint |
|---|---|
| Instagram profile, posts, or comments | /v1/instagram/profile, /v2/instagram/user/posts, /v1/instagram/post, /v2/instagram/post/comments |
| TikTok profile, posts, search, trends | /v1/tiktok/profile, /v3/tiktok/profile/videos, /v2/tiktok/video, /v1/tiktok/search/hashtag, /v1/tiktok/get-trending-feed |
| YouTube video, channel, transcript, comments | /v1/youtube/video, /v1/youtube/channel, /v1/youtube/video/transcript, /v1/youtube/video/comments |
| X profile, posts, or post details | /v1/twitter/profile, /v1/twitter/user-tweets, /v1/twitter/tweet |
| LinkedIn profile, company, posts, or ads | /v1/linkedin/profile, /v1/linkedin/company, /v1/linkedin/post, /v1/linkedin/ads/search |
| Meta Ad Library | /v1/facebook/adLibrary/search/ads, /v1/facebook/adLibrary/ad |
| TikTok Ad Library | Resolve the current search and ad-detail operations from the official OpenAPI |
| Google advertiser ads | /v1/google/company/ads, /v1/google/ad |
| TikTok Shop products, reviews, and creator showcases | Resolve the current shop search, product, review, and user-showcase operations from the official OpenAPI |
| Instagram and YouTube discovery | Resolve current Reel, audio, Shorts, hashtag, search, and trend operations from the official OpenAPI |
| Reddit, Threads, Bluesky, and Pinterest research | Resolve current search, profile, post, comment, board, and pin operations from the official OpenAPI |
| Public creator links and shops | Resolve current Linktree, Komi, Pillar, Linkbio, Linkme, and Amazon Shop operations from the official OpenAPI |
Most operations are GET requests. ScrapeCreators' official OpenAPI currently also defines POST variants for Meta ad search, Meta company ads, and Reddit post comments. Use POST only when the official operation requires it:
provider: scrapecreators
method: POST
path: /v1/facebook/adLibrary/search/ads
body:
query: running shoes
country: USEndpoint names can change. If a request fails or the exact parameters are unclear, read https://docs.scrapecreators.com/openapi.json before guessing.
Provider calls should return a normalized source set for the parent workflow:
{
"platform": "instagram",
"query": "brand",
"collected_at": "ISO-8601",
"items": [{"id":"...","url":"...","author":"...","published_at":"...","text":"...","metrics":{}}],
"next_cursor": null,
"limitations": []
}This is a provider skill. Do not stop after dumping API output; return control to the research skill that requested the data.
Research supported advertising promises from a specific buyer's context, current product facts, customer language and observed ads. Turn them into static, video or copy ideas; match video ideas to actual recipes and save a product-scoped angle bank for write-video-ad-script. Product-led discovery can use verified facts without reviews. Reference persistence and reach are observations, not proof of performance.
Analyze ad campaign performance data (Google, Meta, LinkedIn) to identify what's working, what's wasting budget, and specific cut/scale/test recommendations. Runs statistical analysis, funnel diagnostics, and multi-channel budget reallocation with specific dollar-amount shift recommendations and scenario modeling.
For paid lead-gen and participant-recruitment ads, replaces vanity CPA with true CAC per qualified lead by joining ad-platform data with downstream funnel events, surfaces tracking gaps, and classifies every creative into Scale / Keep / Investigate / Cut.
One install prompt gives you a Grok bot that researches your brand, makes ads and product photos, writes social posts and finds influencers.