Communitygithub.com

ScrapeCreators API

27以上のソーシャルメディアプラットフォームから公開データをスクレイピング・抽出します。110のエンドポイントを提供。

ScrapeCreators API とは?

ScrapeCreators API スキルは、AIエージェント(Claude Code、Cursor、Codexなど)が27以上のソーシャルメディアプラットフォームから公開されているデータをプログラムで抽出できるようにする開発者ツールです。TikTok、Instagram、YouTube、LinkedIn、Facebook、X/Twitter、Reddit、Threadsなどのプロフィール、投稿、コメント、トランスクリプト、検索結果、広告ライブラリデータにアクセスするための110以上のエンドポイントを提供します。このスキルは、エージェントがユーザーの意図を適切なAPIエンドポイントにルーティングし、パラメータの詳細を取得するためにエンドポイント固有のOpenAPI仕様を動的にフェッチし、認証には`x-api-key`ヘッダーを使用して安全なGETリクエストを実行することを可能にします。この統合により、AIエージェントは大量の公開ソーシャルメディアデータをワークフロー、分析、自動化に活用できるようになります。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ScrapeCreators/social-media-research-skills/tree/main/skills/scrapecreators-api

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ScrapeCreators API は何をしますか?

27以上のソーシャルメディアプラットフォームから公開データをスクレイピング・抽出します。110のエンドポイントが利用可能です。

ベースURL: https://api.scrapecreators.com

APIキーは https://scrapecreators.com で取得してください。

呼び出し方

すべてのエンドポイントはGETリクエストを使用します。URLにクエリパラメータを渡し、x-api-keyヘッダーで認証します。レスポンスはJSONです。

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

または 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();

エンドポイントパスは /v1/platform/action のパターンを使用します。以下の表に各エンドポイントパスと必須パラメータを示します。

API仕様

各エンドポイントには、https://docs.scrapecreators.com/{path}/openapi.json に独自のOpenAPI仕様があります。

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

重要: 以下のルーティングテーブルから呼び出すエンドポイントを決定したら、まずその単一エンドポイントのOpenAPI仕様を取得して、完全なパラメータ詳細、型、および応答例を確認してから実際のAPI呼び出しを行ってください。

すべてのエンドポイントをカバーする完全な仕様は https://docs.scrapecreators.com/openapi.json にあります(大きなファイルです — 上記のエンドポイント固有の仕様を優先してください)。

インテントルーティング

ユーザーの意図を適切なエンドポイントにマッピングします。エンドポイントを選択したら、https://docs.scrapecreators.com/{path}/openapi.json でOpenAPI仕様を取得し、呼び出す前に完全なパラメータ詳細を確認してください。

プロフィール / ユーザー情報

プラットフォームエンドポイント主要パラメータ例
TikTok/v1/tiktok/profilehandlestoolpresidente
Instagram/v1/instagram/profilehandlejane
YouTube/v1/youtube/channelhandle, channelId, または urlThePatMcAfeeShow
LinkedIn (個人)/v1/linkedin/profileurlhttps://www.linkedin.com/in/parrsam/
LinkedIn (企業)/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 または 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

投稿 / コンテンツフィード

プラットフォームエンドポイント主要パラメータ例
TikTok 動画/v3/tiktok/profile/videoshandlestoolpresidente
Instagram 投稿/v2/instagram/user/postshandlejane
Instagram リール/v1/instagram/user/reelshandle または user_idjane または 2700692569
Instagram ハイライト/v1/instagram/user/highlightshandle または user_idjane または 2700692569
YouTube 動画/v1/youtube/channel/videoshandle または channelIdThePatMcAfeeShow
YouTube ショート/v1/youtube/channel/shortshandle または channelIdstarterstory
YouTube プレイリスト/v1/youtube/playlistplaylist_idPLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS
LinkedIn 投稿/v1/linkedin/company/postsurlhttps://linkedin.com/company/shopify
Facebook 投稿/v1/facebook/profile/postsurl または pageIdhttps://www.facebook.com/pacemorby
Facebook リール/v1/facebook/profile/reelsurlhttps://www.facebook.com/Spurs
Facebook 写真/v1/facebook/profile/photosurlhttps://www.facebook.com/Spurs
Facebook グループ投稿/v1/facebook/group/postsurl または group_id742354120555345
Twitter ツイート/v1/twitter/user/tweetshandleelonmusk
Reddit 投稿/v1/reddit/subredditsubredditAskReddit
Threads 投稿/v1/threads/user/postshandlezuck
Bluesky 投稿/v1/bluesky/user/postshandle または user_idjay.bsky.team
Truth Social 投稿/v1/truthsocial/user/postshandle または user_idrealDonaldTrump
Pinterest ボード/v1/pinterest/boardurlhttps://www.pinterest.com/...

単一投稿 / 動画詳細

プラットフォームエンドポイント主要パラメータ例
TikTok/v2/tiktok/videourlhttps://www.tiktok.com/@randomspamvideos25/video/7251387037834595630
Instagram/v1/instagram/posturlhttps://www.instagram.com/reel/DOq6eV6iIgD
Instagram ハイライト/v1/instagram/user/highlight/detailid18067016518767507
YouTube/v1/youtube/videourlhttps://www.youtube.com/watch?v=Y2Ah_DFr8cw
YouTube コミュニティ投稿/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 コミュニティ/v1/twitter/communityurlhttps://twitter.com/i/communities/...
Twitter/X コミュニティツイート/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 クリップ/v1/twitch/clipurlhttps://clips.twitch.tv/...
Kick クリップ/v1/kick/clipurlhttps://kick.com/...

コメント

プラットフォームエンドポイント主要パラメータ例
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 または feedback_idhttps://www.facebook.com/reel/753347914167361
Reddit/v1/reddit/post/commentsurlhttps://www.reddit.com/r/AskReddit/comments/...

トランスクリプト

プラットフォームエンドポイント例注記
TikTok/v1/tiktok/video/transcripturl=https://www.tiktok.com/...&lang=en/v2/tiktok/video で get_transcript=true でも可
Instagram/v2/instagram/media/transcripturl=https://www.instagram.com/reel/...AI駆動、10~30秒、2分未満
YouTube/v1/youtube/video/transcripturl=https://www.youtube.com/watch?v=bjVIDXPP7Uk/v1/youtube/video のレスポンスにも含まれます
Facebook/v1/facebook/post/transcripturl=https://www.facebook.com/reel/...2分未満のみ
Twitter/X/v1/twitter/tweet/transcripturl=https://twitter.com/...AI駆動、低速

検索

プラットフォームエンドポイント主要パラメータ例
TikTok ユーザー/v1/tiktok/search/usersqueryfunny
TikTok 動画 (キーワード)/v1/tiktok/search/keywordqueryfunny
TikTok 動画 (ハッシュタグ)/v1/tiktok/search/hashtaghashtagfyp
TikTok トップ (写真+動画)/v1/tiktok/search/topqueryfunny
Instagram リール/v2/instagram/reels/searchquerydogs
YouTube/v1/youtube/searchqueryfunny
YouTube ハッシュタグ/v1/youtube/search/hashtaghashtagfunny
Reddit (すべて)/v1/reddit/searchquerybest programming languages
Reddit (サブレディット内)/v1/reddit/subreddit/searchsubreddit + queryAskReddit + funny
Threads 投稿/v1/threads/searchqueryAI
Threads ユーザー/v1/threads/search/usersqueryzuck
Pinterest/v1/pinterest/searchqueryhome decor
Google/v1/google/searchquerybest restaurants in NYC

広告ライブラリ

プラットフォームエンドポイント主要パラメータ例
Facebook 広告検索/v1/facebook/adLibrary/search/adsqueryrunning
Facebook 企業広告/v1/facebook/adLibrary/company/adspageId または companyNameLululemon
Facebook 広告詳細/v1/facebook/adLibrary/adid または url702369045530963
Facebook 企業検索/v1/facebook/adLibrary/search/companiesqueryNike
Google 企業広告/v1/google/company/adsdomain または advertiser_idnike.com
Google 広告詳細/v1/google/adurlhttps://adstransparency.google.com/...
Google 広告主検索/v1/google/adLibrary/advertisers/searchqueryNike
LinkedIn 広告検索/v1/linkedin/ads/searchcompany または keywordShopify
LinkedIn 広告詳細/v1/linkedin/adurlhttps://www.linkedin.com/ad/...
Reddit 広告検索/v1/reddit/ads/searchquerygaming
Reddit 広告詳細/v1/reddit/adidt3_abc123

トレンド / 人気

コンテンツエンドポイントパラメータ例
トレンドフィード/v1/tiktok/get-trending-feedregion (必須)US
人気動画/v1/tiktok/videos/popular
人気クリエイター/v1/tiktok/creators/popular
人気ハッシュタグ/v1/tiktok/hashtags/popular
人気楽曲/v1/tiktok/songs/popular
楽曲詳細/v1/tiktok/songclipId7439295283975702544
楽曲使用動画/v1/tiktok/song/videosclipId7439295283975702544
トレンドショート (YT)/v1/youtube/shorts/trending

フォロワー / フォロー中 / ライブ (TikTokのみ)

タイプエンドポイント例
フォロー中/v1/tiktok/user/followinghandle=stoolpresidente
フォロワー/v1/tiktok/user/followershandle=stoolpresidente
オーディエンスデモグラフィック/v1/tiktok/user/audience (26クレジット!)handle=shakira
ライブストリーム/v1/tiktok/user/livehandle=thejustalex

TikTok Shop

タイプエンドポイント主要パラメータ例
商品検索/v1/tiktok/shop/searchqueryshoes
ストア商品/v1/tiktok/shop/productsurlhttps://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079
商品詳細/v1/tiktok/producturlhttps://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies.../1729587769570529799
商品レビュー/v1/tiktok/shop/product/reviewsurl または product_id1731578642912612516
ユーザーショーケース/v1/tiktok/user/showcasehandlemrtiktokreviews

リンクインバイオ / その他

サービスエンドポイントパラメータ例
Linktree/v1/linktreeurlhttps://linktr.ee/...
Komi/v1/komiurlhttps://komi.io/...
Pillar/v1/pillarurlhttps://pillar.io/...
Linkbio/v1/linkbiourlhttps://linkbio.co/...
Linkme/v1/linkmeurlhttps://linkme.bio/...
Amazon Shop/v1/amazon/shopurlhttps://www.amazon.com/shop/...
Instagram 基本プロフィール/v1/instagram/basic/profileuserId314216
Instagram 埋め込みHTML/v1/instagram/user/embedhandlejane
年齢/性別検出/v1/detect/age-genderurl (ソーシャルプロフィール)https://www.tiktok.com/@charlidamelio
クレジット残高/v1/credit/balance(なし)

クレジットコスト

ほとんどのエンドポイントはリクエストごとに 1クレジット です。例外は以下の通り:

エンドポイントコスト条件
/v1/tiktok/user/audience26 クレジット常時
/v1/tiktok/video/transcript+10 クレジットuse_ai_as_fallback=true の場合
/v1/google/company/ads25 クレジットget_ad_details=true の場合

残高は /v1/credit/balance で確認してください。高額なエンドポイントを呼び出す前にユーザーに警告してください。

ページネーション

ページネーション対応のエンドポイントは、レスポンス内にカーソル/トークンを返します。それをクエリパラメータとして再度渡すことで、次のページを取得できます。

カーソルフィールド使用先
cursorTikTok コメント/検索/楽曲動画、Instagram コメント、Reddit サブレディット検索、Pinterest、Bluesky、Facebook リール/写真/投稿/コメント、TikTok Shop 商品/ユーザーショーケース
max_cursorTikTok プロフィール動画
min_timeTikTok フォロー中/フォロワー
continuationTokenYouTube (すべてのページネーション対応エンドポイント)
afterReddit 投稿、Reddit 検索
next_max_idInstagram 投稿、Truth Social 投稿
max_idInstagram リール
pageTikTok 人気/ショップ、Instagram リール検索、LinkedIn 企業投稿、TikTok Shop レビュー
paginationTokenLinkedIn 広告

共通オプションパラメータ

  • trim (boolean): レスポンスペイロードサイズを削減します。主要なメトリクスのみが必要な場合に使用します。
  • region (string): プロキシロケーション用の2文字の国コード。地域でフィルタリングは行いません — その国のプロキシを介してリクエストをルーティングするだけです。

既知の制限事項

  • ハンドル: @ 記号なしで渡します。@charlidamelio ではなく charlidamelio を使用します。TikTok、Instagram、Twitter、Threads、Bluesky、Snapchat、Twitch、Pinterest、Truth Social に適用されます。
  • YouTube ハンドル: @ 記号なしで渡します。@ThePatMcAfeeShow ではなく ThePatMcAfeeShow を使用します。代わりに channelId (例: UC-9-kyTW8ZkZNDHQJ6FgpwQ) または完全なURLを渡すこともできます。
  • ハッシュタグ: # 記号なしで渡します。#fyp ではなく fyp を使用します。TikTok に適用されます。

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

ad-library-teardown

Use when the user wants to analyze active ads from Meta/Facebook, Google, or LinkedIn ad libraries; tear down a competitor

audience-research

Use when the user wants to evaluate a creator, influencer, or brand audience using public profile signals, TikTok audience demographics, follower/following data, comments, geography, language, and content fit. Helps judge sponsorship and market fit.

comment-mining

Use when the user wants to mine comments and replies for audience reactions, customer language, questions, objections, complaints, product ideas, buying intent, sentiment, or voice-of-customer insights from public social posts and videos.

competitor-social-research

Use when the user wants to research competitors

content-repurposing

Use when the user wants to turn public social videos, transcripts, posts, or creator research into reusable content assets such as LinkedIn posts, X threads, short-form scripts, newsletters, blog outlines, carousels, or content calendars.

creator-profile-teardown

Use when the user wants to analyze a creator, influencer, founder, or brand social account and understand positioning, content pillars, outlier posts, hooks, format choices, audience reaction, and what can be copied or tested.

influencer-prospecting

Use when the user wants to find creators, influencers, affiliates, or social accounts in a niche for outreach, partnerships, sponsorships, UGC, seeding, or competitive research. Produces scored prospect lists from public social data.

outlier-post-finder

Use when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline. Finds outliers, explains why they worked, extracts hooks and formats, and produces a practical swipe file.

product-demand-research

Use when the user wants to validate a product idea, find pain points, mine demand signals, discover objections, or gather voice-of-customer language from Reddit, social posts, video transcripts, and comments. Produces evidence-backed product research.

social-listening-brief

Use when the user wants a social listening report about what people are saying about a brand, person, product, topic, category, or niche across public social platforms. Produces cited themes, sentiment caveats, notable posts, and recommended actions.

transcript-intelligence

Use when the user wants to summarize, analyze, or repurpose transcripts from TikTok, Instagram, YouTube, Facebook, X/Twitter, LinkedIn, Rumble, or Reddit video posts. Extracts hooks, claims, quotes, content atoms, themes, and reusable scripts.

trend-discovery

Use when the user wants to discover trending social topics, hashtags, sounds, posts, reels, shorts, creators, or formats in a niche. Searches public trend and discovery endpoints, ranks evidence, and turns trends into practical content angles.

関連スキル