mcpField
S
scrapecreators-api

scrapecreators-api

github.com/scrapecreatorsデータ・データベース5.0k1.4k 回インストール9 週間前に更新
リポジトリ

scrapecreators-api について

ScrapeCreators APIは、ソーシャルプラットフォームや関連サービスの公開データを取得するためのAPIです。データ収集ワークフローを構築する開発者向けで、各エンドポイントの仕様は個別のOpenAPIドキュメントで確認できます。

主な機能

  1. 0127以上のプラットフォームの公開データ取得
  2. 02110のAPIエンドポイント
  3. 03プロフィール、投稿、コメント、文字起こし
  4. 04検索、トレンド、広告ライブラリのデータ
  5. 05エンドポイントごとのOpenAPI仕様

活用シーン

  1. 01ソーシャルプロフィールや投稿データの収集
  2. 02投稿やプラットフォームのトレンド検索
  3. 03動画の文字起こしやコメントの取得
  4. 04対応プラットフォームの広告調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/scrapecreators/social-media-research-skills --skill scrapecreators-api

インストール後、Claude Code で/scrapecreators-apiを入力して読み込まれたか確認します。

詳細

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 仕様

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

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

重要： 以下のルーティング表から呼び出すエンドポイントを選んだら、実際に API を呼び出す前に、まずそのエンドポイント専用の OpenAPI 仕様を取得して、パラメーターの詳細、型、レスポンス例を確認してください。

すべてのエンドポイントを網羅した完全な仕様は https://docs.scrapecreators.com/openapi.json にあります（ファイルサイズが大きいため、上記のエンドポイントごとの仕様を優先してください）。

インテントルーティング

ユーザーのインテントに適したエンドポイントを割り当てます。エンドポイントを選択したら、呼び出す前に https://docs.scrapecreators.com/{path}/openapi.json から仕様を取得し、パラメーターの詳細を確認してください。

プロフィール／ユーザー情報
プラットフォームエンドポイント主なパラメーター例
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
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/...
コメント
プラットフォームエンドポイント主なパラメーター例
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=enget_transcript=true を指定して /v2/tiktok/video からも取得可能
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
Link-in-Bio／その他
サービスエンドポイントパラメーター例
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 と YouTube のハッシュタグ検索エンドポイントに適用されます
  • Twitter：時系列順または最新のものではなく、人気の高いツイートを約100件返します
  • Threads：公開状態で閲覧できる投稿は直近20～30件のみです
  • Facebook の投稿：1ページあたり3件のみです（API の制限）
  • Facebook グループの投稿：1ページあたり3件のみです（同じ API の制限）
  • LinkedIn の企業投稿：最大7ページです
  • Instagram の再生回数：Instagram での再生回数のみです（Facebook へのクロスポストでの再生回数は含まれません）
  • Truth Social：著名なユーザー（Trump、Vance など）のみ公開状態で機能します
  • Instagram の楽曲リール：非推奨です（エンドポイントは存在しますが、機能しません）
  • トランスクリプト：すべてのトランスクリプトエンドポイントで、動画の長さが2分未満である必要があります
  • Reddit のサブレディット名：大文字と小文字が区別されます。askreddit ではなく "AskReddit" を使用してください

コメント

Markdown 対応