Scrapecreators API skill
-
by ScrapeCreators·MIT license·★ 2,619 Stars on the repo·GitHub ↗
Use now
npx degit ScrapeCreators/social-media-research-skills/skills/scrapecreators-api#main ~/.claude/skills/scrapecreators-apiChecked ·commit main
Files of Scrapecreators API
SKILL.md
Show the full text291 lines
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
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok | /v1/tiktok/profile |
handle | stoolpresidente |
/v1/instagram/profile |
handle | jane |
|
| YouTube | /v1/youtube/channel |
handle, channelId, or url | ThePatMcAfeeShow |
| LinkedIn (person) | /v1/linkedin/profile |
url | https://www.linkedin.com/in/parrsam/ |
| LinkedIn (company) | /v1/linkedin/company |
url | https://linkedin.com/company/shopify |
/v1/facebook/profile |
url | https://www.facebook.com/mantraindianfolsom |
|
| Twitter/X | /v1/twitter/profile |
handle | elonmusk |
/v1/reddit/subreddit/details |
subreddit or url | AskReddit |
|
| Threads | /v1/threads/profile |
handle | zuck |
| Bluesky | /v1/bluesky/profile |
handle | jay.bsky.team |
/v1/pinterest/user/boards |
handle | pinterest |
|
| Truth Social | /v1/truthsocial/profile |
handle | realDonaldTrump |
| Twitch | /v1/twitch/profile |
handle | ninja |
| Snapchat | /v1/snapchat/profile |
handle | djkhaled |
Posts / Content Feeds
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok videos | /v3/tiktok/profile/videos |
handle | stoolpresidente |
| Instagram posts | /v2/instagram/user/posts |
handle | jane |
| Instagram reels | /v1/instagram/user/reels |
handle or user_id | jane or 2700692569 |
| Instagram highlights | /v1/instagram/user/highlights |
handle or user_id | jane or 2700692569 |
| YouTube videos | /v1/youtube/channel/videos |
handle or channelId | ThePatMcAfeeShow |
| YouTube shorts | /v1/youtube/channel/shorts |
handle or channelId | starterstory |
| YouTube playlist | /v1/youtube/playlist |
playlist_id | PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS |
| LinkedIn posts | /v1/linkedin/company/posts |
url | https://linkedin.com/company/shopify |
| Facebook posts | /v1/facebook/profile/posts |
url or pageId | https://www.facebook.com/pacemorby |
| Facebook reels | /v1/facebook/profile/reels |
url | https://www.facebook.com/Spurs |
| Facebook photos | /v1/facebook/profile/photos |
url | https://www.facebook.com/Spurs |
| Facebook group posts | /v1/facebook/group/posts |
url or group_id | 742354120555345 |
| Twitter tweets | /v1/twitter/user/tweets |
handle | elonmusk |
| Reddit posts | /v1/reddit/subreddit |
subreddit | AskReddit |
| Threads posts | /v1/threads/user/posts |
handle | zuck |
| Bluesky posts | /v1/bluesky/user/posts |
handle or user_id | jay.bsky.team |
| Truth Social posts | /v1/truthsocial/user/posts |
handle or user_id | realDonaldTrump |
| Pinterest board | /v1/pinterest/board |
url | https://www.pinterest.com/... |
Single Post / Video Details
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok | /v2/tiktok/video |
url | https://www.tiktok.com/@randomspamvideos25/video/7251387037834595630 |
/v1/instagram/post |
url | https://www.instagram.com/reel/DOq6eV6iIgD |
|
| Instagram highlight | /v1/instagram/user/highlight/detail |
id | 18067016518767507 |
| YouTube | /v1/youtube/video |
url | https://www.youtube.com/watch?v=Y2Ah_DFr8cw |
| YouTube community post | /v1/youtube/community-post |
url | https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8 |
/v1/linkedin/post |
url | https://www.linkedin.com/pulse/being-father-has-made-me-better-leader... |
|
/v1/facebook/post |
url | https://www.facebook.com/reel/1535656380759655 |
|
| Twitter/X | /v1/twitter/tweet |
url | https://twitter.com/elonmusk/status/... |
| Twitter/X community | /v1/twitter/community |
url | https://twitter.com/i/communities/... |
| Twitter/X community tweets | /v1/twitter/community/tweets |
url | https://twitter.com/i/communities/... |
/v1/reddit/post/comments |
url | https://www.reddit.com/r/AskReddit/comments/... |
|
| Threads | /v1/threads/post |
url | https://www.threads.net/@zuck/post/... |
| Bluesky | /v1/bluesky/post |
url | https://bsky.app/profile/.../post/... |
| Truth Social | /v1/truthsocial/post |
url | https://truthsocial.com/@realDonaldTrump/posts/... |
/v1/pinterest/pin |
url | https://www.pinterest.com/pin/... |
|
| Twitch clip | /v1/twitch/clip |
url | https://clips.twitch.tv/... |
| Kick clip | /v1/kick/clip |
url | https://kick.com/... |
Comments
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok | /v1/tiktok/video/comments |
url | https://www.tiktok.com/@stoolpresidente/video/7499229683859426602 |
/v2/instagram/post/comments |
url | https://www.instagram.com/reel/DOq6eV6iIgD |
|
| YouTube | /v1/youtube/video/comments |
url | https://www.youtube.com/watch?v=dQw4w9WgXcQ |
/v1/facebook/post/comments |
url or feedback_id | https://www.facebook.com/reel/753347914167361 |
|
/v1/reddit/post/comments |
url | https://www.reddit.com/r/AskReddit/comments/... |
Transcripts
| Platform | Endpoint | Example | Note |
|---|---|---|---|
| TikTok | /v1/tiktok/video/transcript |
url=https://www.tiktok.com/...&lang=en |
also via /v2/tiktok/video with get_transcript=true |
/v2/instagram/media/transcript |
url=https://www.instagram.com/reel/... |
AI-powered, 10-30s, under 2min | |
| YouTube | /v1/youtube/video/transcript |
url=https://www.youtube.com/watch?v=bjVIDXPP7Uk |
also included in /v1/youtube/video response |
/v1/facebook/post/transcript |
url=https://www.facebook.com/reel/... |
under 2min only | |
| Twitter/X | /v1/twitter/tweet/transcript |
url=https://twitter.com/... |
AI-powered, slow |
Search
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok users | /v1/tiktok/search/users |
query | funny |
| TikTok videos (keyword) | /v1/tiktok/search/keyword |
query | funny |
| TikTok videos (hashtag) | /v1/tiktok/search/hashtag |
hashtag | fyp |
| TikTok top (photos+videos) | /v1/tiktok/search/top |
query | funny |
| Instagram reels | /v2/instagram/reels/search |
query | dogs |
| YouTube | /v1/youtube/search |
query | funny |
| YouTube hashtag | /v1/youtube/search/hashtag |
hashtag | funny |
| Reddit (all) | /v1/reddit/search |
query | best programming languages |
| Reddit (in subreddit) | /v1/reddit/subreddit/search |
subreddit + query | AskReddit + funny |
| Threads posts | /v1/threads/search |
query | AI |
| Threads users | /v1/threads/search/users |
query | zuck |
/v1/pinterest/search |
query | home decor |
|
/v1/google/search |
query | best restaurants in NYC |
Ad Libraries
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| Facebook ads search | /v1/facebook/adLibrary/search/ads |
query | running |
| Facebook company ads | /v1/facebook/adLibrary/company/ads |
pageId or companyName | Lululemon |
| Facebook ad detail | /v1/facebook/adLibrary/ad |
id or url | 702369045530963 |
| Facebook find companies | /v1/facebook/adLibrary/search/companies |
query | Nike |
| Google company ads | /v1/google/company/ads |
domain or advertiser_id | nike.com |
| Google ad detail | /v1/google/ad |
url | https://adstransparency.google.com/... |
| Google find advertisers | /v1/google/adLibrary/advertisers/search |
query | Nike |
| LinkedIn ads search | /v1/linkedin/ads/search |
company or keyword | Shopify |
| LinkedIn ad detail | /v1/linkedin/ad |
url | https://www.linkedin.com/ad/... |
| Reddit ads search | /v1/reddit/ads/search |
query | gaming |
| Reddit ad detail | /v1/reddit/ad |
id | t3_abc123 |
Trending / Popular
| Content | Endpoint | Param | Example |
|---|---|---|---|
| Trending feed | /v1/tiktok/get-trending-feed |
region (required) | US |
| Popular videos | /v1/tiktok/videos/popular |
||
| Popular creators | /v1/tiktok/creators/popular |
||
| Popular hashtags | /v1/tiktok/hashtags/popular |
||
| Popular songs | /v1/tiktok/songs/popular |
||
| Song details | /v1/tiktok/song |
clipId | 7439295283975702544 |
| Videos using song | /v1/tiktok/song/videos |
clipId | 7439295283975702544 |
| Trending shorts (YT) | /v1/youtube/shorts/trending |
Followers / Following / Live (TikTok only)
| Type | Endpoint | Example |
|---|---|---|
| Following | /v1/tiktok/user/following |
handle=stoolpresidente |
| Followers | /v1/tiktok/user/followers |
handle=stoolpresidente |
| Audience demographics | /v1/tiktok/user/audience (26 credits!) |
handle=shakira |
| Live stream | /v1/tiktok/user/live |
handle=thejustalex |
TikTok Shop
| Type | Endpoint | Primary Param | Example |
|---|---|---|---|
| Search products | /v1/tiktok/shop/search |
query | shoes |
| Store products | /v1/tiktok/shop/products |
url | https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079 |
| Product detail | /v1/tiktok/product |
url | https://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies.../1729587769570529799 |
| Product reviews | /v1/tiktok/shop/product/reviews |
url or product_id | 1731578642912612516 |
| User showcase | /v1/tiktok/user/showcase |
handle | mrtiktokreviews |
Link-in-Bio / Other
| Service | Endpoint | Param | Example |
|---|---|---|---|
| Linktree | /v1/linktree |
url | https://linktr.ee/... |
| Komi | /v1/komi |
url | https://komi.io/... |
| Pillar | /v1/pillar |
url | https://pillar.io/... |
| Linkbio | /v1/linkbio |
url | https://linkbio.co/... |
| Linkme | /v1/linkme |
url | https://linkme.bio/... |
| Amazon Shop | /v1/amazon/shop |
url | https://www.amazon.com/shop/... |
| Instagram basic profile | /v1/instagram/basic/profile |
userId | 314216 |
| Instagram embed HTML | /v1/instagram/user/embed |
handle | jane |
| Age/Gender detect | /v1/detect/age-gender |
url (social profile) | https://www.tiktok.com/@charlidamelio |
| Credit balance | /v1/credit/balance |
(none) |
Credit Costs
Most endpoints cost 1 credit per request. Exceptions:
| Endpoint | Cost | Condition |
|---|---|---|
/v1/tiktok/user/audience |
26 credits | always |
/v1/tiktok/video/transcript |
+10 credits | when use_ai_as_fallback=true |
/v1/google/company/ads |
25 credits | when get_ad_details=true |
Check balance with /v1/credit/balance. Warn users before calling expensive endpoints.
Pagination
Paginated endpoints return a cursor/token in the response. Pass it back as a query param to get the next page.
| Cursor Field | Used By |
|---|---|
cursor |
TikTok comments/search/song videos, Instagram comments, Reddit subreddit search, Pinterest, Bluesky, Facebook reels/photos/posts/comments, TikTok Shop products/user showcase |
max_cursor |
TikTok profile videos |
min_time |
TikTok following/followers |
continuationToken |
YouTube (all paginated endpoints) |
after |
Reddit posts, Reddit search |
next_max_id |
Instagram posts, Truth Social posts |
max_id |
Instagram reels |
page |
TikTok popular/shop, Instagram reels search, LinkedIn company posts, TikTok Shop reviews |
paginationToken |
LinkedIn ads |
Common Optional Params
trim(boolean): reduces response payload size. Use when you only need key metrics.region(string): 2-letter country code for proxy location. Does NOT filter by region -- just routes the request through that country's proxy.
Known Limitations
- Handles: pass without the
@symbol. Usecharlidamelionot@charlidamelio. Applies to TikTok, Instagram, Twitter, Threads, Bluesky, Snapchat, Twitch, Pinterest, Truth Social - YouTube handles: pass without the
@symbol. UseThePatMcAfeeShownot@ThePatMcAfeeShow. You can also pass a channelId (e.g.UC-9-kyTW8ZkZNDHQJ6FgpwQ) or full URL instead - Hashtags: pass without the
#symbol. Usefypnot#fyp. Applies to TikTok and YouTube hashtag search endpoints - Twitter: returns ~100 most popular tweets, not chronological/latest
- Threads: only last 20-30 posts visible publicly
- Facebook posts: only 3 posts per page (API limitation)
- Facebook group posts: only 3 posts per page (same API limitation)
- LinkedIn company posts: max 7 pages
- Instagram play counts: IG-only views (excludes cross-posted FB views)
- Truth Social: only prominent users (Trump, Vance, etc.) work publicly
- Instagram song reels: deprecated (endpoint exists but non-functional)
- Transcripts: all transcript endpoints require video under 2 minutes
- Reddit subreddit names: case-sensitive! Use "AskReddit" not "askreddit"
| 1 | |
| 2 | name scrapecreators-api |
| 3 | description >- |
| 4 | Scrape and extract public data from 27+ social media platforms using the |
| 5 | ScrapeCreators REST API. Covers TikTok, Instagram, YouTube, LinkedIn, |
| 6 | Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, Snapchat, Twitch, |
| 7 | Kick, Truth Social, TikTok Shop, Google, and link-in-bio services (Linktree, |
| 8 | Komi, Pillar, Linkbio, Linkme, Amazon Shop). Use when the user asks to |
| 9 | scrape, fetch, extract, search, or look up social media profiles, posts, |
| 10 | videos, reels, comments, transcripts, followers, ads, hashtags, trending |
| 11 | content, or engagement metrics from any social platform. Also use when user |
| 12 | mentions ScrapeCreators, social media API, ad library, or creator data. |
| 13 | allowed-tools Bash, Read, Write, WebFetch |
| 14 | homepage https://scrapecreators.com |
| 15 | metadata |
| 16 | openclaw |
| 17 | emoji "🔍" |
| 18 | requires |
| 19 | env |
| 20 | - SCRAPECREATORS_API_KEY |
| 21 | primaryEnv SCRAPECREATORS_API_KEY |
| 22 | homepage https://scrapecreators.com |
| 23 | tags |
| 24 | - scraping |
| 25 | - social-media |
| 26 | - tiktok |
| 27 | |
| 28 | - youtube |
| 29 | |
| 30 | |
| 31 | |
| 32 | |
| 33 | - threads |
| 34 | - bluesky |
| 35 | |
| 36 | - snapchat |
| 37 | - twitch |
| 38 | - truth-social |
| 39 | - tiktok-shop |
| 40 | |
| 41 | - ad-library |
| 42 | - creator-data |
| 43 | - transcripts |
| 44 | - trending |
| 45 | |
| 46 | |
| 47 | # ScrapeCreators API |
| 48 | |
| 49 | Scrape and extract public data from 27+ social media platforms. 110 endpoints available. |
| 50 | |
| 51 | **Base URL:** `https://api.scrapecreators.com` |
| 52 | |
| 53 | Get your API key at https://scrapecreators.com |
| 54 | |
| 55 | ## How to Call |
| 56 | |
| 57 | All endpoints use GET requests. Pass query params in the URL and authenticate with the `x-api-key` header. Responses are JSON. |
| 58 | |
| 59 | |
| 60 | curl -s "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio" \ |
| 61 | -H "x-api-key: $SCRAPECREATORS_API_KEY" |
| 62 | |
| 63 | |
| 64 | Or with `fetch`: |
| 65 | |
| 66 | |
| 67 | const res = await fetch( |
| 68 | "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio", |
| 69 | { headers: { "x-api-key": process.env.SCRAPECREATORS_API_KEY } } |
| 70 | ); |
| 71 | const data = await res.json(); |
| 72 | |
| 73 | |
| 74 | Endpoint paths use the pattern `/v1/platform/action`. The tables below list each endpoint path and its required params. |
| 75 | |
| 76 | ### API Spec |
| 77 | |
| 78 | Each endpoint has its own OpenAPI spec at `https://docs.scrapecreators.com/{path}/openapi.json`. |
| 79 | |
| 80 | For example: https://docs.scrapecreators.com/v1/tiktok/profile/openapi.json |
| 81 | |
| 82 | **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. |
| 83 | |
| 84 | The full spec covering all endpoints is at https://docs.scrapecreators.com/openapi.json (large file — prefer the per-endpoint specs above). |
| 85 | |
| 86 | ## Intent Routing |
| 87 | |
| 88 | 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. |
| 89 | |
| 90 | ### Profiles / User Info |
| 91 | | Platform | Endpoint | Primary Param | Example | |
| 92 | |----------|----------|---------------|---------| |
| 93 | | TikTok | `/v1/tiktok/profile` | handle | `stoolpresidente` | |
| 94 | | Instagram | `/v1/instagram/profile` | handle | `jane` | |
| 95 | | YouTube | `/v1/youtube/channel` | handle, channelId, or url | `ThePatMcAfeeShow` | |
| 96 | | LinkedIn (person) | `/v1/linkedin/profile` | url | `https://www.linkedin.com/in/parrsam/` | |
| 97 | | LinkedIn (company) | `/v1/linkedin/company` | url | `https://linkedin.com/company/shopify` | |
| 98 | | Facebook | `/v1/facebook/profile` | url | `https://www.facebook.com/mantraindianfolsom` | |
| 99 | | Twitter/X | `/v1/twitter/profile` | handle | `elonmusk` | |
| 100 | | Reddit | `/v1/reddit/subreddit/details` | subreddit or url | `AskReddit` | |
| 101 | | Threads | `/v1/threads/profile` | handle | `zuck` | |
| 102 | | Bluesky | `/v1/bluesky/profile` | handle | `jay.bsky.team` | |
| 103 | | Pinterest | `/v1/pinterest/user/boards` | handle | `pinterest` | |
| 104 | | Truth Social | `/v1/truthsocial/profile` | handle | `realDonaldTrump` | |
| 105 | | Twitch | `/v1/twitch/profile` | handle | `ninja` | |
| 106 | | Snapchat | `/v1/snapchat/profile` | handle | `djkhaled` | |
| 107 | |
| 108 | ### Posts / Content Feeds |
| 109 | | Platform | Endpoint | Primary Param | Example | |
| 110 | |----------|----------|---------------|---------| |
| 111 | | TikTok videos | `/v3/tiktok/profile/videos` | handle | `stoolpresidente` | |
| 112 | | Instagram posts | `/v2/instagram/user/posts` | handle | `jane` | |
| 113 | | Instagram reels | `/v1/instagram/user/reels` | handle or user_id | `jane` or `2700692569` | |
| 114 | | Instagram highlights | `/v1/instagram/user/highlights` | handle or user_id | `jane` or `2700692569` | |
| 115 | | YouTube videos | `/v1/youtube/channel/videos` | handle or channelId | `ThePatMcAfeeShow` | |
| 116 | | YouTube shorts | `/v1/youtube/channel/shorts` | handle or channelId | `starterstory` | |
| 117 | | YouTube playlist | `/v1/youtube/playlist` | playlist_id | `PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS` | |
| 118 | | LinkedIn posts | `/v1/linkedin/company/posts` | url | `https://linkedin.com/company/shopify` | |
| 119 | | Facebook posts | `/v1/facebook/profile/posts` | url or pageId | `https://www.facebook.com/pacemorby` | |
| 120 | | Facebook reels | `/v1/facebook/profile/reels` | url | `https://www.facebook.com/Spurs` | |
| 121 | | Facebook photos | `/v1/facebook/profile/photos` | url | `https://www.facebook.com/Spurs` | |
| 122 | | Facebook group posts | `/v1/facebook/group/posts` | url or group_id | `742354120555345` | |
| 123 | | Twitter tweets | `/v1/twitter/user/tweets` | handle | `elonmusk` | |
| 124 | | Reddit posts | `/v1/reddit/subreddit` | subreddit | `AskReddit` | |
| 125 | | Threads posts | `/v1/threads/user/posts` | handle | `zuck` | |
| 126 | | Bluesky posts | `/v1/bluesky/user/posts` | handle or user_id | `jay.bsky.team` | |
| 127 | | Truth Social posts | `/v1/truthsocial/user/posts` | handle or user_id | `realDonaldTrump` | |
| 128 | | Pinterest board | `/v1/pinterest/board` | url | `https://www.pinterest.com/...` | |
| 129 | |
| 130 | ### Single Post / Video Details |
| 131 | | Platform | Endpoint | Primary Param | Example | |
| 132 | |----------|----------|---------------|---------| |
| 133 | | TikTok | `/v2/tiktok/video` | url | `https://www.tiktok.com/@randomspamvideos25/video/7251387037834595630` | |
| 134 | | Instagram | `/v1/instagram/post` | url | `https://www.instagram.com/reel/DOq6eV6iIgD` | |
| 135 | | Instagram highlight | `/v1/instagram/user/highlight/detail` | id | `18067016518767507` | |
| 136 | | YouTube | `/v1/youtube/video` | url | `https://www.youtube.com/watch?v=Y2Ah_DFr8cw` | |
| 137 | | YouTube community post | `/v1/youtube/community-post` | url | `https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8` | |
| 138 | | LinkedIn | `/v1/linkedin/post` | url | `https://www.linkedin.com/pulse/being-father-has-made-me-better-leader...` | |
| 139 | | Facebook | `/v1/facebook/post` | url | `https://www.facebook.com/reel/1535656380759655` | |
| 140 | | Twitter/X | `/v1/twitter/tweet` | url | `https://twitter.com/elonmusk/status/...` | |
| 141 | | Twitter/X community | `/v1/twitter/community` | url | `https://twitter.com/i/communities/...` | |
| 142 | | Twitter/X community tweets | `/v1/twitter/community/tweets` | url | `https://twitter.com/i/communities/...` | |
| 143 | | Reddit | `/v1/reddit/post/comments` | url | `https://www.reddit.com/r/AskReddit/comments/...` | |
| 144 | | Threads | `/v1/threads/post` | url | `https://www.threads.net/@zuck/post/...` | |
| 145 | | Bluesky | `/v1/bluesky/post` | url | `https://bsky.app/profile/.../post/...` | |
| 146 | | Truth Social | `/v1/truthsocial/post` | url | `https://truthsocial.com/@realDonaldTrump/posts/...` | |
| 147 | | Pinterest | `/v1/pinterest/pin` | url | `https://www.pinterest.com/pin/...` | |
| 148 | | Twitch clip | `/v1/twitch/clip` | url | `https://clips.twitch.tv/...` | |
| 149 | | Kick clip | `/v1/kick/clip` | url | `https://kick.com/...` | |
| 150 | |
| 151 | ### Comments |
| 152 | | Platform | Endpoint | Primary Param | Example | |
| 153 | |----------|----------|---------------|---------| |
| 154 | | TikTok | `/v1/tiktok/video/comments` | url | `https://www.tiktok.com/@stoolpresidente/video/7499229683859426602` | |
| 155 | | Instagram | `/v2/instagram/post/comments` | url | `https://www.instagram.com/reel/DOq6eV6iIgD` | |
| 156 | | YouTube | `/v1/youtube/video/comments` | url | `https://www.youtube.com/watch?v=dQw4w9WgXcQ` | |
| 157 | | Facebook | `/v1/facebook/post/comments` | url or feedback_id | `https://www.facebook.com/reel/753347914167361` | |
| 158 | | Reddit | `/v1/reddit/post/comments` | url | `https://www.reddit.com/r/AskReddit/comments/...` | |
| 159 | |
| 160 | ### Transcripts |
| 161 | | Platform | Endpoint | Example | Note | |
| 162 | |----------|----------|---------|------| |
| 163 | | TikTok | `/v1/tiktok/video/transcript` | `url=https://www.tiktok.com/...&lang=en` | also via `/v2/tiktok/video` with get_transcript=true | |
| 164 | | Instagram | `/v2/instagram/media/transcript` | `url=https://www.instagram.com/reel/...` | AI-powered, 10-30s, under 2min | |
| 165 | | YouTube | `/v1/youtube/video/transcript` | `url=https://www.youtube.com/watch?v=bjVIDXPP7Uk` | also included in `/v1/youtube/video` response | |
| 166 | | Facebook | `/v1/facebook/post/transcript` | `url=https://www.facebook.com/reel/...` | under 2min only | |
| 167 | | Twitter/X | `/v1/twitter/tweet/transcript` | `url=https://twitter.com/...` | AI-powered, slow | |
| 168 | |
| 169 | ### Search |
| 170 | | Platform | Endpoint | Primary Param | Example | |
| 171 | |----------|----------|---------------|---------| |
| 172 | | TikTok users | `/v1/tiktok/search/users` | query | `funny` | |
| 173 | | TikTok videos (keyword) | `/v1/tiktok/search/keyword` | query | `funny` | |
| 174 | | TikTok videos (hashtag) | `/v1/tiktok/search/hashtag` | hashtag | `fyp` | |
| 175 | | TikTok top (photos+videos) | `/v1/tiktok/search/top` | query | `funny` | |
| 176 | | Instagram reels | `/v2/instagram/reels/search` | query | `dogs` | |
| 177 | | YouTube | `/v1/youtube/search` | query | `funny` | |
| 178 | | YouTube hashtag | `/v1/youtube/search/hashtag` | hashtag | `funny` | |
| 179 | | Reddit (all) | `/v1/reddit/search` | query | `best programming languages` | |
| 180 | | Reddit (in subreddit) | `/v1/reddit/subreddit/search` | subreddit + query | `AskReddit` + `funny` | |
| 181 | | Threads posts | `/v1/threads/search` | query | `AI` | |
| 182 | | Threads users | `/v1/threads/search/users` | query | `zuck` | |
| 183 | | Pinterest | `/v1/pinterest/search` | query | `home decor` | |
| 184 | | Google | `/v1/google/search` | query | `best restaurants in NYC` | |
| 185 | |
| 186 | ### Ad Libraries |
| 187 | | Platform | Endpoint | Primary Param | Example | |
| 188 | |----------|----------|---------------|---------| |
| 189 | | Facebook ads search | `/v1/facebook/adLibrary/search/ads` | query | `running` | |
| 190 | | Facebook company ads | `/v1/facebook/adLibrary/company/ads` | pageId or companyName | `Lululemon` | |
| 191 | | Facebook ad detail | `/v1/facebook/adLibrary/ad` | id or url | `702369045530963` | |
| 192 | | Facebook find companies | `/v1/facebook/adLibrary/search/companies` | query | `Nike` | |
| 193 | | Google company ads | `/v1/google/company/ads` | domain or advertiser_id | `nike.com` | |
| 194 | | Google ad detail | `/v1/google/ad` | url | `https://adstransparency.google.com/...` | |
| 195 | | Google find advertisers | `/v1/google/adLibrary/advertisers/search` | query | `Nike` | |
| 196 | | LinkedIn ads search | `/v1/linkedin/ads/search` | company or keyword | `Shopify` | |
| 197 | | LinkedIn ad detail | `/v1/linkedin/ad` | url | `https://www.linkedin.com/ad/...` | |
| 198 | | Reddit ads search | `/v1/reddit/ads/search` | query | `gaming` | |
| 199 | | Reddit ad detail | `/v1/reddit/ad` | id | `t3_abc123` | |
| 200 | |
| 201 | ### Trending / Popular |
| 202 | | Content | Endpoint | Param | Example | |
| 203 | |---------|----------|-------|---------| |
| 204 | | Trending feed | `/v1/tiktok/get-trending-feed` | region (required) | `US` | |
| 205 | | Popular videos | `/v1/tiktok/videos/popular` | | | |
| 206 | | Popular creators | `/v1/tiktok/creators/popular` | | | |
| 207 | | Popular hashtags | `/v1/tiktok/hashtags/popular` | | | |
| 208 | | Popular songs | `/v1/tiktok/songs/popular` | | | |
| 209 | | Song details | `/v1/tiktok/song` | clipId | `7439295283975702544` | |
| 210 | | Videos using song | `/v1/tiktok/song/videos` | clipId | `7439295283975702544` | |
| 211 | | Trending shorts (YT) | `/v1/youtube/shorts/trending` | | | |
| 212 | |
| 213 | ### Followers / Following / Live (TikTok only) |
| 214 | | Type | Endpoint | Example | |
| 215 | |------|----------|---------| |
| 216 | | Following | `/v1/tiktok/user/following` | `handle=stoolpresidente` | |
| 217 | | Followers | `/v1/tiktok/user/followers` | `handle=stoolpresidente` | |
| 218 | | Audience demographics | `/v1/tiktok/user/audience` (26 credits!) | `handle=shakira` | |
| 219 | | Live stream | `/v1/tiktok/user/live` | `handle=thejustalex` | |
| 220 | |
| 221 | ### TikTok Shop |
| 222 | | Type | Endpoint | Primary Param | Example | |
| 223 | |------|----------|---------------|---------| |
| 224 | | Search products | `/v1/tiktok/shop/search` | query | `shoes` | |
| 225 | | Store products | `/v1/tiktok/shop/products` | url | `https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079` | |
| 226 | | Product detail | `/v1/tiktok/product` | url | `https://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies.../1729587769570529799` | |
| 227 | | Product reviews | `/v1/tiktok/shop/product/reviews` | url or product_id | `1731578642912612516` | |
| 228 | | User showcase | `/v1/tiktok/user/showcase` | handle | `mrtiktokreviews` | |
| 229 | |
| 230 | ### Link-in-Bio / Other |
| 231 | | Service | Endpoint | Param | Example | |
| 232 | |---------|----------|-------|---------| |
| 233 | | Linktree | `/v1/linktree` | url | `https://linktr.ee/...` | |
| 234 | | Komi | `/v1/komi` | url | `https://komi.io/...` | |
| 235 | | Pillar | `/v1/pillar` | url | `https://pillar.io/...` | |
| 236 | | Linkbio | `/v1/linkbio` | url | `https://linkbio.co/...` | |
| 237 | | Linkme | `/v1/linkme` | url | `https://linkme.bio/...` | |
| 238 | | Amazon Shop | `/v1/amazon/shop` | url | `https://www.amazon.com/shop/...` | |
| 239 | | Instagram basic profile | `/v1/instagram/basic/profile` | userId | `314216` | |
| 240 | | Instagram embed HTML | `/v1/instagram/user/embed` | handle | `jane` | |
| 241 | | Age/Gender detect | `/v1/detect/age-gender` | url (social profile) | `https://www.tiktok.com/@charlidamelio` | |
| 242 | | Credit balance | `/v1/credit/balance` | (none) | | |
| 243 | |
| 244 | ## Credit Costs |
| 245 | |
| 246 | Most endpoints cost **1 credit** per request. Exceptions: |
| 247 | |
| 248 | | Endpoint | Cost | Condition | |
| 249 | |----------|------|-----------| |
| 250 | | `/v1/tiktok/user/audience` | 26 credits | always | |
| 251 | | `/v1/tiktok/video/transcript` | +10 credits | when `use_ai_as_fallback=true` | |
| 252 | | `/v1/google/company/ads` | 25 credits | when `get_ad_details=true` | |
| 253 | |
| 254 | Check balance with `/v1/credit/balance`. Warn users before calling expensive endpoints. |
| 255 | |
| 256 | ## Pagination |
| 257 | |
| 258 | Paginated endpoints return a cursor/token in the response. Pass it back as a query param to get the next page. |
| 259 | |
| 260 | | Cursor Field | Used By | |
| 261 | |-------------|---------| |
| 262 | | `cursor` | TikTok comments/search/song videos, Instagram comments, Reddit subreddit search, Pinterest, Bluesky, Facebook reels/photos/posts/comments, TikTok Shop products/user showcase | |
| 263 | | `max_cursor` | TikTok profile videos | |
| 264 | | `min_time` | TikTok following/followers | |
| 265 | | `continuationToken` | YouTube (all paginated endpoints) | |
| 266 | | `after` | Reddit posts, Reddit search | |
| 267 | | `next_max_id` | Instagram posts, Truth Social posts | |
| 268 | | `max_id` | Instagram reels | |
| 269 | | `page` | TikTok popular/shop, Instagram reels search, LinkedIn company posts, TikTok Shop reviews | |
| 270 | | `paginationToken` | LinkedIn ads | |
| 271 | |
| 272 | ## Common Optional Params |
| 273 | |
| 274 | **`trim`** (boolean): reduces response payload size. Use when you only need key metrics. |
| 275 | **`region`** (string): 2-letter country code for proxy location. Does NOT filter by region -- just routes the request through that country's proxy. |
| 276 | |
| 277 | ## Known Limitations |
| 278 | |
| 279 | **Handles**: pass without the `@` symbol. Use `charlidamelio` not `@charlidamelio`. Applies to TikTok, Instagram, Twitter, Threads, Bluesky, Snapchat, Twitch, Pinterest, Truth Social |
| 280 | **YouTube handles**: pass without the `@` symbol. Use `ThePatMcAfeeShow` not `@ThePatMcAfeeShow`. You can also pass a channelId (e.g. `UC-9-kyTW8ZkZNDHQJ6FgpwQ`) or full URL instead |
| 281 | **Hashtags**: pass without the `#` symbol. Use `fyp` not `#fyp`. Applies to TikTok and YouTube hashtag search endpoints |
| 282 | **Twitter**: returns ~100 most popular tweets, not chronological/latest |
| 283 | **Threads**: only last 20-30 posts visible publicly |
| 284 | **Facebook posts**: only 3 posts per page (API limitation) |
| 285 | **Facebook group posts**: only 3 posts per page (same API limitation) |
| 286 | **LinkedIn company posts**: max 7 pages |
| 287 | **Instagram play counts**: IG-only views (excludes cross-posted FB views) |
| 288 | **Truth Social**: only prominent users (Trump, Vance, etc.) work publicly |
| 289 | **Instagram song reels**: deprecated (endpoint exists but non-functional) |
| 290 | **Transcripts**: all transcript endpoints require video under 2 minutes |
| 291 | **Reddit subreddit names**: case-sensitive! Use "AskReddit" not "askreddit" |
Discussion
Alternatives
API and interface designGuides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.
Context7Pulls up-to-date, version-specific library docs and code examples into the prompt so the AI stops inventing old APIs.Context7 Documentation LookupFetch up-to-date documentation and code examples for any library, framework, SDK, CLI tool, or cloud service. Use whenever the user asks about a specific library — even well-known ones like React, Next.js, Prisma, Express, Tailwind, Django, or Spring Boot — because training data may not reflect recent API changes or version updates. Always use for: API syntax questions, configuration options, version migration issues, "how do I" questions mentioning a library name, debugging that involves library-specific behavior, setup instructions, and CLI tool usage. Use even when you think you know the answer. Do not rely on training data for API details, signatures, or configuration options — they are frequently out of date. Prefer this over web search for library documentation.
Adaptyv Bio Foundry APIHow to use the Adaptyv Bio Foundry API and Python SDK for protein experiment design, submission, and results retrieval. Use this skill whenever the user mentions Adaptyv, Foundry API, protein binding assays, protein screening experiments, BLI/SPR assays, thermostability assays, or wants to submit protein sequences for experimental characterization. Also trigger when code imports `adaptyv`, `adaptyv_sdk`, or `FoundryClient`, or references `foundry-api-public.adaptyvbio.com`.Browse more free Claude skills or everything in Development.