scrapecreators/social-media-research-skills1 file

Scrapecreators API

>-

Specification
Skill ID
scrapecreators/social-media-research-skills/scrapecreators-api
Publisher
scrapecreators
Repository
social-media-research-skills
Installs
0
Files
1
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

scrapecreators/social-media-research-skills/scrapecreators-apiInstalls these files
  • SKILL.md

What this skill tells the agent

ScrapeCreators API

Scrape and extract public data from 27+ social media platforms. 110 endpoints available.

Base URL: https://api.scrapecreators.com

Get your API key at https://scrapecreators.com

How to Call

All endpoints use GET requests. Pass query params in the URL and authenticate with the x-api-key header. Responses are JSON.

curl -s "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio" \
  -H "x-api-key: $SCRAPECREATORS_API_KEY"

Or with fetch:

const res = await fetch(
  "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio",
  { headers: { "x-api-key": process.env.SCRAPECREATORS_API_KEY } }
);
const data = await res.json();

Endpoint paths use the pattern /v1/platform/action. The tables below list each endpoint path and its required params.

API Spec

Each endpoint has its own OpenAPI spec at https://docs.scrapecreators.com/{path}/openapi.json.

For example: https://docs.scrapecreators.com/v1/tiktok/profile/openapi.json

Important: Once you've determined which endpoint(s) to call from the routing tables below, fetch the single-endpoint OpenAPI spec first to get the full parameter details, types, and example response before making the actual API call.

The full spec covering all endpoints is at https://docs.scrapecreators.com/openapi.json (large file — prefer the per-endpoint specs above).

Intent Routing

Map user intent to the right endpoint. After selecting an endpoint, fetch its OpenAPI spec at https://docs.scrapecreators.com/{path}/openapi.json for full param details before calling.

Profiles / User Info

PlatformEndpointPrimary ParamExample
TikTok/v1/tiktok/profilehandlestoolpresidente
Instagram/v1/instagram/profilehandlejane
YouTube/v1/youtube/channelhandle, channelId, or urlThePatMcAfeeShow
LinkedIn (person)/v1/linkedin/profileurlhttps://www.linkedin.com/in/parrsam/
LinkedIn (company)/v1/linkedin/companyurlhttps://linkedin.com/company/shopify
Facebook/v1/facebook/profileurlhttps://www.facebook.com/mantraindianfolsom
Twitter/X/v1/twitter/profilehandleelonmusk
Reddit/v1/reddit/subreddit/detailssubreddit or urlAskReddit
Threads/v1/threads/profilehandlezuck
Bluesky/v1/bluesky/profilehandlejay.bsky.team
Pinterest/v1/pinterest/user/boardshandlepinterest
Truth Social/v1/truthsocial/profilehandlerealDonaldTrump
Twitch/v1/twitch/profilehandleninja
Snapchat/v1/snapchat/profilehandledjkhaled

Posts / Content Feeds

PlatformEndpointPrimary ParamExample
TikTok videos/v3/tiktok/profile/videoshandlestoolpresidente
Instagram posts/v2/instagram/user/postshandlejane
Instagram reels/v1/instagram/user/reelshandle or user_idjane or 2700692569
Instagram highlights/v1/instagram/user/highlightshandle or user_idjane or 2700692569
YouTube videos/v1/youtube/channel/videoshandle or channelIdThePatMcAfeeShow
YouTube shorts/v1/youtube/channel/shortshandle or channelIdstarterstory
YouTube playlist/v1/youtube/playlistplaylist_idPLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS
LinkedIn posts/v1/linkedin/company/postsurlhttps://linkedin.com/company/shopify
Facebook posts/v1/facebook/profile/postsurl or pageIdhttps://www.facebook.com/pacemorby
Facebook reels/v1/facebook/profile/reelsurlhttps://www.facebook.com/Spurs
Facebook photos/v1/facebook/profile/photosurlhttps://www.facebook.com/Spurs
Facebook group posts/v1/facebook/group/postsurl or group_id742354120555345
Twitter tweets/v1/twitter/user/tweetshandleelonmusk
Reddit posts/v1/reddit/subredditsubredditAskReddit
Threads posts/v1/threads/user/postshandlezuck
Bluesky posts/v1/bluesky/user/postshandle or user_idjay.bsky.team
Truth Social posts/v1/truthsocial/user/postshandle or user_idrealDonaldTrump
Pinterest board/v1/pinterest/boardurlhttps://www.pinterest.com/...

Single Post / Video Details

PlatformEndpointPrimary ParamExample
TikTok/v2/tiktok/videourlhttps://www.tiktok.com/@randomspamvideos25/video/7251387037834595630
Instagram/v1/instagram/posturlhttps://www.instagram.com/reel/DOq6eV6iIgD
Instagram highlight/v1/instagram/user/highlight/detailid18067016518767507
YouTube/v1/youtube/videourlhttps://www.youtube.com/watch?v=Y2Ah_DFr8cw
YouTube community post/v1/youtube/community-posturlhttps://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8
LinkedIn/v1/linkedin/posturlhttps://www.linkedin.com/pulse/being-father-has-made-me-better-leader...
Facebook/v1/facebook/posturlhttps://www.facebook.com/reel/1535656380759655
Twitter/X/v1/twitter/tweeturlhttps://twitter.com/elonmusk/status/...
Twitter/X community/v1/twitter/communityurlhttps://twitter.com/i/communities/...
Twitter/X community tweets/v1/twitter/community/tweetsurlhttps://twitter.com/i/communities/...
Reddit/v1/reddit/post/commentsurlhttps://www.reddit.com/r/AskReddit/comments/...
Threads/v1/threads/posturlhttps://www.threads.net/@zuck/post/...
Bluesky/v1/bluesky/posturlhttps://bsky.app/profile/.../post/...
Truth Social/v1/truthsocial/posturlhttps://truthsocial.com/@realDonaldTrump/posts/...
Pinterest/v1/pinterest/pinurlhttps://www.pinterest.com/pin/...
Twitch clip/v1/twitch/clipurlhttps://clips.twitch.tv/...
Kick clip/v1/kick/clipurlhttps://kick.com/...

Comments

PlatformEndpointPrimary ParamExample
TikTok/v1/tiktok/video/commentsurlhttps://www.tiktok.com/@stoolpresidente/video/7499229683859426602
Instagram/v2/instagram/post/commentsurlhttps://www.instagram.com/reel/DOq6eV6iIgD
YouTube/v1/youtube/video/commentsurlhttps://www.youtube.com/watch?v=dQw4w9WgXcQ
Facebook/v1/facebook/post/commentsurl or feedback_idhttps://www.facebook.com/reel/753347914167361
Reddit/v1/reddit/post/commentsurlhttps://www.reddit.com/r/AskReddit/comments/...

Transcripts

PlatformEndpointExampleNote
TikTok/v1/tiktok/video/transcripturl=https://www.tiktok.com/...&lang=enalso via /v2/tiktok/video with get_transcript=true
Instagram/v2/instagram/media/transcripturl=https://www.instagram.com/reel/...AI-powered, 10-30s, under 2min
YouTube/v1/youtube/video/transcripturl=https://www.youtube.com/watch?v=bjVIDXPP7Ukalso included in /v1/youtube/video response
Facebook/v1/facebook/post/transcripturl=https://www.facebook.com/reel/...under 2min only
Twitter/X/v1/twitter/tweet/transcripturl=https://twitter.com/...AI-powered, slow

Search

PlatformEndpointPrimary ParamExample
TikTok users/v1/tiktok/search/usersqueryfunny
TikTok videos (keyword)/v1/tiktok/search/keywordqueryfunny
TikTok videos (hashtag)/v1/tiktok/search/hashtaghashtagfyp
TikTok top (photos+videos)/v1/tiktok/search/topqueryfunny
Instagram reels/v2/instagram/reels/searchquerydogs

Use this skill in a project

Open any RiverX project, search the Skills panel for scrapecreators/social-media-research-skills/scrapecreators-api, and install it in one click.

Use this skill