X API

공개 X 데이터 API

Name: X Data API
Brand: SocialCrawl
Availability: InStock

SocialCrawl API 키로 공개 X(Twitter) 프로필, 트윗, 커뮤니티, AI 검색, 대본을 구조화 JSON으로 가져옵니다. Post, Comment, Author 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.

문서 보기 동작 방식 직접 호출

/v1/twitter

활성 엔드포인트는 8개입니다.

GET /v1/twitter/profile
GET /v1/twitter/profile/full
GET /v1/twitter/user/tweets
GET /v1/twitter/tweet
GET /v1/twitter/tweet/transcript
GET /v1/twitter/ai-search
GET /v1/twitter/community
GET /v1/twitter/community/tweets

X 엔드포인트

공개 X 읽기 엔드포인트는 8개입니다. 프로필, 타임라인, 단일 트윗, AI 검색, 커뮤니티, 대본을 제공합니다. 데이터 API만 지원합니다.

프로필

1 크레딧

/v1/twitter/profile

공개 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

handle

전체 프로필

5 크레딧

/v1/twitter/profile/full

공개 전체 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

handle, posts, cursor, include

사용자 트윗

1 크레딧

/v1/twitter/user/tweets

공개 사용자 트윗 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

handle, trim

트윗

1 크레딧

/v1/twitter/tweet

공개 트윗 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

url, trim

트윗 대본

10 크레딧

/v1/twitter/tweet/transcript

공개 대본 또는 자막 데이터를 반환합니다. 없으면 환불될 수 있습니다.

url

AI 검색

5 크레딧

/v1/twitter/ai-search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, from_handles, exclude_handles, from_date, to_date

커뮤니티

1 크레딧

/v1/twitter/community

공개 커뮤니티 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

url

커뮤니티 트윗

1 크레딧

/v1/twitter/community/tweets

공개 커뮤니티 트윗 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

url

X API15개 엔드포인트 지원

문서 보기

X(Twitter) 계정의 공개 프로필을 돌려줍니다: 팔로워 수, 팔로잉 수, 트윗 수, 소개, 프로필과 배너 이미지 URL, 인증 여부.

handle을 갖고 있고 트윗을 가져오기 전에 계정을 빠르게 훑어볼 때 사용하세요.

1크레딧

GET/v1/twitter/profile?handle=elonmusk

handle

handle · Twitter username without the @ symbol

$ curl https://www.socialcrawl.dev/v1/twitter/profile?handle=elonmusk \
    -H "x-api-key: sc_YOUR_API_KEY"

대기 중

// 파라미터를 수정한 뒤 "실행해보기"를 누르면 실제 응답을 받습니다

X API 동작 방식

X(Twitter)도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/twitter/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.

연동 순서

대부분 제품은 계정을 확인한 뒤 목록을 보고 필요한 게시물만 깊게 읽습니다.

01계정

GET /v1/twitter/profile

Author 형태 프로필입니다.

핸들 또는 id를 한 번 확정합니다.

02목록

GET /v1/twitter/profile/full

최근 공개 항목의 PostList입니다.

라우트가 지원하면 cursor 또는 after로 페이지를 넘깁니다.

03항목

GET /v1/twitter/user/tweets

URL 또는 id 기준 전체 Post입니다.

목록 행만으로 부족할 때 사용합니다.

04댓글

GET /v1/twitter/tweet

플랫폼이 제공하는 CommentList입니다.

스레드가 중요할 때만 확장합니다.

요청

GET /v1/twitter/profile
  ?handle=elonmusk
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

응답 봉투

{
  "success": true,
  "data": { "/* Author | Post | PostList | CommentList | … */": true },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.

Authorprofile

id, username, display_name, avatar_url, bio, followers, url, ext

PostList / Postprofile/full

items[].post에 id, url, content, engagement, author, published_at, ext

CommentListuser/tweets

댓글 라우트가 있을 때 items[]에 author, content.text, engagement, published_at

Search / Mediatweet

검색 결과, 미디어 메타데이터, 대본 등 라우트별 필드

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.

엣지 수신

Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.

검증 후 차감

레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.

캐시 또는 수집

platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.

정규화 후 반환

upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

표준 라이브 미스: 티어 비용(보통 1 크레딧)
고급 읽기: 보통 5 크레딧
프리미엄 읽기: 보통 10 크레딧
종량제 라우트: 문서화된 최소 바닥
캐시 히트: 0 크레딧
빈 응답·하드 실패: 자동 환불
잘못된 파라미터: 400, 미과금
크레딧 부족: 402, 미과금
비활성 라우트: 503, 미과금

데이터 수집 방식

X(Twitter)은 SocialCrawl의 공개 읽기 데이터입니다. 공유 스키마로 정규화하므로 별도 OAuth를 배울 필요가 없습니다.

이 API에서의 X

레지스트리에 노출된 공개 X(Twitter) 표면입니다. 연구·모니터링·제품 작업을 위한 읽기 전용입니다.

SocialCrawl 접근 방식

하나의 게이트웨이 뒤에서 소셜 읽기 upstream을 호출합니다. 등록된 두꺼운 라우트는 Prism 컴포지트로 단계를 묶습니다.

엣지에서 나가는 형태

success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. Author / Post / Comment 리프를 공유합니다.

제공하지 않는 범위

쓰기 엔드포인트와 비공개 수신함은 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다.

필드 매핑

public profile / channel→ author.*프로필 식별자와 카운터

public post / media→ post.* / items[].post게시물 본문과 참여 지표

list / search page→ items[] or hits댓글 또는 검색 결과

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

8active X endpoints in the registry

1 / 5 / 10표준·고급·프리미엄 크레딧 단계

X 실시간 내러티브·계정 모니터링

호출은 X(Twitter) 프로필, 콘텐츠 목록, 검색, 심화 경로에 집중됩니다. 공유 스키마의 AI 검색과 프로필·트윗 읽기입니다. 이 표면에는 별도 X 개발자 앱이 필요하지 않습니다.

상세 읽기는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 컴포지트는 더 느린 경로입니다.

X API 활용 사례

X 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

소셜 리스닝날짜 구간과 계정 필터를 지원하는 근거 기반 검색입니다.

크리에이터 분석추적 중인 계정의 프로필을 해석하고 최근 게시물을 조회합니다.

인플루언서 검색해당 네트워크에서 활동하는 크리에이터의 프로필과 최근 게시물을 조회합니다.

계정 통합 조회X에서 같은 대상의 프로필과 최근 게시물을 조회합니다.

트렌드 감지날짜 필터를 지원하는 근거 기반 검색으로 지금 그 검색어가 어떻게 규정되는지 확인합니다.

시장 조사날짜 구간과 계정 필터를 지원하는 근거 기반 검색으로 카테고리가 공개적으로 논의되는 양상을 확인합니다.

영상 자막게시물이 텍스트를 그대로 포함하므로 검색과 게시물 상세만으로 문구를 확인합니다.

뉴스·공개출처 모니터링날짜 구간과 계정 필터를 지원하는 근거 기반 검색으로 X에서 해당 사안이 논의되는 양상을 확인합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

모니터링 잡

Python, cron, Slack 봇

X(Twitter) 프로필과 피드를 폴링합니다. 참여 속도가 뛰면 알립니다.

리서치·VoC

Node, 노트북, BI 적재

X(Twitter)에서 검색 후 게시물을 확장해 브랜드·제품·경쟁 언어를 모읍니다.

백엔드 제품 잡

Go, 워커, Explorer

해석-목록-상세를 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.

두 줄로 호출

라이브 미스는 티어별 크레딧을 사용합니다. 캐시 히트는 무료입니다. 빈 응답과 하드 실패는 환불됩니다.

curl "https://www.socialcrawl.dev/v1/twitter/profile?handle=elonmusk" \
  -H "x-api-key: sc_your_api_key_here"

curl "https://www.socialcrawl.dev/v1/twitter/profile/full?handle=example" \
  -H "x-api-key: sc_your_api_key_here"

SocialCrawl의 X

카탈로그 전 구간과 같은 키

플랫폼 문서 API 키 받기

엔드포인트

X API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

ProfileGet Twitter user profile User TweetsList Twitter user tweets TweetGet Twitter tweet details CommunityGet Twitter community details Community TweetsList Twitter community tweets Tweet TranscriptGet Twitter video transcript Ai SearchAI-powered X (Twitter) search via xAI Grok Search TweetsSearch Twitter tweets Tweet RepliesList Twitter tweet replies User MediaList Twitter user media tweets User FollowersList Twitter user followers User FollowingList Twitter user following Tweet RetweetersList Twitter tweet retweeters Search UsersSearch Twitter users Profile FullX (Twitter) profile, recent posts, and computed analytics in one call.

비교

SocialCrawl과 공식 X API, 뭐가 다른가요?

같은 X 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

항목	SocialCrawl	공식 X API
인증	x-api-key 헤더 하나면 돼요	개발자 앱 자격 증명과 OAuth 2.0이 필요해요
설정·심사	가입 후 바로 호출할 수 있어요	개발자 포털 가입과 유료 요금제 선택을 거쳐야 해요
레이트 리밋	크레딧 기반이라 쓴 만큼만 차감돼요	티어별 호출 상한이 있고 하위 티어는 읽기가 크게 제한돼요
응답 스키마	51개 플랫폼이 공유하는 통합 JSON이에요	X 전용 페이로드를 직접 매핑해야 해요
요금	호출당 1 크레딧(영상 자막은 10), 100 크레딧 무료예요	의미 있는 읽기 권한은 유료 티어부터 열려요
데이터 범위	프로필·트윗·커뮤니티·자막·AI 검색 등 공개 데이터 읽기 전용이에요	포스팅, DM, 실시간 스트림까지 공식 기능 전체를 쓸 수 있어요
유지보수	X 내부가 바뀌어도 스키마가 그대로 유지돼요	API 버전과 정책 변경을 직접 따라가야 해요

인증

SocialCrawl

x-api-key 헤더 하나면 돼요

공식 X API

개발자 앱 자격 증명과 OAuth 2.0이 필요해요

설정·심사

SocialCrawl

가입 후 바로 호출할 수 있어요

공식 X API

개발자 포털 가입과 유료 요금제 선택을 거쳐야 해요

레이트 리밋

SocialCrawl

크레딧 기반이라 쓴 만큼만 차감돼요

공식 X API

티어별 호출 상한이 있고 하위 티어는 읽기가 크게 제한돼요

응답 스키마

SocialCrawl

51개 플랫폼이 공유하는 통합 JSON이에요

공식 X API

X 전용 페이로드를 직접 매핑해야 해요

요금

SocialCrawl

호출당 1 크레딧(영상 자막은 10), 100 크레딧 무료예요

공식 X API

의미 있는 읽기 권한은 유료 티어부터 열려요

데이터 범위

SocialCrawl

프로필·트윗·커뮤니티·자막·AI 검색 등 공개 데이터 읽기 전용이에요

공식 X API

포스팅, DM, 실시간 스트림까지 공식 기능 전체를 쓸 수 있어요

유지보수

SocialCrawl

X 내부가 바뀌어도 스키마가 그대로 유지돼요

공식 X API

API 버전과 정책 변경을 직접 따라가야 해요

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기

Twitter와 X 데이터를 API로 어떻게 수집하나요?

x-api-key 헤더와 함께 GET 요청을 보내면 돼요. SocialCrawl의 Twitter 엔드포인트 15종은 OAuth 인증, 개발자 심사, 월 $200 X API 요금제 없이 핸들이나 URL만으로 호출할 수 있어요. 응답은 통합 스키마에 engagement_rate 같은 AI 보강 필드까지 함께 담겨 와요.

SocialCrawl은 어떤 Twitter / X 엔드포인트를 지원하나요?

총 15종이에요. profile(핸들로 사용자 프로필), user/tweets(사용자 최신 트윗), tweet(트윗 URL 상세), community(X 커뮤니티 정보), community/tweets(커뮤니티 게시물), tweet/transcript(트윗 영상 자막), ai-search(xAI Grok 기반 AI 검색)를 비롯해 필요한 데이터를 바로 가져올 수 있어요.

Twitter API는 요금이 얼마인가요?

프로필, 사용자 트윗, 트윗 상세, 커뮤니티, 커뮤니티 트윗, AI 검색 엔드포인트는 호출당 1 크레딧(스탠다드)이에요. 트윗 영상 자막은 10 크레딧(프리미엄)이고요. 새 계정에는 100 크레딧이 무료로 들어가서 신용카드 없이 약 100건을 받아볼 수 있어요.

X 개발자 계정이나 OAuth 토큰이 필요한가요?

필요 없어요. X Developer 계정, OAuth 토큰, Basic·Pro 요금제, Twitter 로그인 없이 SocialCrawl x-api-key와 핸들 또는 트윗 URL만 있으면 돼요. 모든 엔드포인트가 통합 스키마로 공개 데이터를 바로 응답해 드려요.

Twitter 데이터를 수집하는 게 법적으로 괜찮나요?

SocialCrawl은 브라우저로 누구나 볼 수 있는 Twitter·X 공개 데이터만 가져와요. 다만 사용 목적이 X 약관과 GDPR·CCPA 같은 개인정보 법령에 맞는지는 직접 확인해 주세요. 공개 데이터라도 활용 방식에 따라 규제가 달라질 수 있어요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.

특정 X 커뮤니티 게시물도 받아볼 수 있나요?

네, X 커뮤니티 전용 엔드포인트 두 종이 있어요. community는 커뮤니티 URL 하나로 이름, 소개, 멤버 수, 규칙을 가져오고, community/tweets는 그 안에 올라온 최신 트윗을 참여 지표와 작성자 정보까지 함께 받아볼 수 있어요.

가장 좋은 Twitter 스크레이퍼 API는 무엇인가요?

읽기 전용 Twitter 데이터라면 SocialCrawl을 추천해요. 프로필, 트윗, X 커뮤니티, 영상 자막, Grok 기반 AI 검색을 비롯해 엔드포인트 15종을 x-api-key 하나로 호출할 수 있어요. 대부분 호출당 1 크레딧이고, 신용카드나 X 개발자 요금제 없이 100 크레딧 무료로 시작할 수 있어요.

X 스크래핑 API와 공식 X API는 뭐가 다른가요?

SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 X 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

X API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요