Communitygithub.com

scrapecreators-api

27개 이상의 소셜 미디어 플랫폼에서 공개 데이터를 스크래핑하고 추출합니다. 110개의 엔드포인트를 제공합니다.

scrapecreators-api란 무엇인가요?

ScrapeCreators API는 개발자와 AI 에이전트가 TikTok, Instagram, YouTube, Twitter/X, Facebook, LinkedIn, Reddit, Threads, Bluesky 등 27개 이상의 소셜 미디어 플랫폼에서 공개 프로필, 게시물, 댓글, 트랜스크립트, 광고 라이브러리, 트렌딩 콘텐츠 등 다양한 데이터를 손쉽게 수집할 수 있도록 설계된 강력한 도구입니다. 110개 이상의 RESTful 엔드포인트를 제공하며, 모든 요청은 GET 메서드를 사용하고 `x-api-key` 헤더로 인증합니다. 이 스킬은 사용자의 의도를 적절한 엔드포인트로 라우팅하고, 각 엔드포인트의 OpenAPI 명세를 참조하여 정확한 파라미터를 구성한 후 API를 호출하는 방식을 통해 Claude Code, Cursor, Codex 등의 AI 에이전트 플랫폼에서 원활하게 작동합니다. 주요 기능으로는 프로필 정보 조회, 게시물 및 콘텐츠 피드 수집, 개별 포스트 상세 정보, 댓글, 트랜스크립트, 검색, 광고 라이브러리 분석, 트렌딩 콘텐츠, 팔로워/팔로잉 정보, TikTok Shop 데이터 등이 있으며, 대부분의 엔드포인트는 요청당 1크레딧만 소모됩니다. 페이지네이션, 트림 파라미터, 리전 설정 등 고급 기능도 지원하여 효율적인 데이터 수집이 가능합니다.

지원 대상~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

https://scrapecreators.com 에서 API 키를 발급받으세요.

호출 방법

모든 엔드포인트는 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/플랫폼/액션 패턴을 사용합니다. 아래 표는 각 엔드포인트 경로와 필수 파라미터를 보여줍니다.

API 명세

각 엔드포인트는 https://docs.scrapecreators.com/{경로}/openapi.json 에서 자체 OpenAPI 명세를 제공합니다.

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

중요: 아래 라우팅 표에서 호출할 엔드포인트를 결정한 후, 먼저 단일 엔드포인트 OpenAPI 명세를 가져와 전체 파라미터 세부 정보, 타입, 예시 응답을 확인한 후 실제 API를 호출하세요.

모든 엔드포인트를 포함한 전체 명세는 https://docs.scrapecreators.com/openapi.json 에 있습니다 (큰 파일 — 위의 개별 엔드포인트 명세를 우선 사용하세요).

의도 라우팅

사용자 의도를 올바른 엔드포인트에 매핑하세요. 엔드포인트를 선택한 후, 전체 파라미터 세부 정보를 확인하기 위해 https://docs.scrapecreators.com/{경로}/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 top (사진+동영상)/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 embed 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 인기/Shop, 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.

관련 스킬