API 목록으로 돌아가기
X 공개 데이터

X 공개 데이터 API

공개 프로필, 팔로워·팔로잉 관계, 게시물, 답글, 인용, 리포스트한 사용자, 검색 결과, 현재 트렌드를 수집합니다. 일관된 결과를 리서치와 모니터링에 활용하세요.

사용할 수 있는 X API

사용자 이름, 게시물 URL, 계정 목록, 검색어, 알고 있는 숫자 WOEID 중 출발점에 맞는 API를 고르세요.

어떤 X 데이터를 가져올 수 있나요?

계정 식별 정보, 알고 있는 콘텐츠, 최근 게시 활동, 게시물 탐색, 위치 기반 최신 주제를 중심으로 데이터셋을 구축하세요.

공개 계정 프로필

사용자 이름을 프로필 식별 정보, 소개, 시각 자산, 계정 상태, 오디언스 지표, 팔로워 목록, 팔로잉 목록, 수집 시각으로 변환합니다.

알고 있는 게시물 상세

공개 게시물 URL을 게시물 상세 정보, 답글, 인용 게시물, 리포스트한 사용자 프로필, 미디어, 관계, 공개된 참여도로 확인합니다.

계정별 최근 게시물

선택한 사용자 이름의 최근 공개 게시물을 답글을 제외하고 수집하며, 계정 목록 전체의 활동을 비교합니다.

게시물 검색과 탐색

검색어 하나로 공개 게시물을 검색하고 최신순 또는 인기순을 선택하며, 모든 결과에 검색어를 연결해 둡니다.

WOEID별 현재 트렌드

트렌드 이름, 원본 순위, 쿼리, 설명, 관측 시각을 위치 기준 스냅샷으로 수집합니다.

SocQ vs X 개발자 제품

SocQ는 일관된 공개 데이터 리서치 워크플로를 위해 만들어졌습니다. X 개발자 제품은 각 제품과 권한 요건에 따라 X가 관리하는 연동을 지원합니다.

워크플로SocQ X 엔드포인트X 개발자 제품
적합한 용도프로필 정보 보강, 게시물 리서치, 모니터링, 공개 주제 탐색X가 관리하는 애플리케이션·계정 연동
시작 입력사용자 이름, 게시물 URL, 계정 목록, 검색식, 알고 있는 WOEID제품별 요청과 권한이 부여된 계정 컨텍스트
인증SocQ API 키X 개발자 자격 증명과 해당 권한
데이터 형태정규화된 프로필, 게시물, 트렌드 레코드제품별 X 고유 응답
처리 방식비동기 작업 후 결과 페이지네이션제품별 요청·응답 수명 주기

X API 작동 방식

모든 X API가 같은 제출, 추적, 가져오기 흐름을 따릅니다.

  1. 1. 입력 제출

    사용자 이름, 게시물 URL, 계정 목록, 검색어, 숫자 WOEID를 알맞은 API에 보냅니다.

  2. 2. 작업 추적

    task_id로 처리가 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 결과 가져오기

    data.results.items를 읽고, has_more가 true인 동안 next_cursor를 사용합니다.

API 요청 한 번으로 시작

SocQ API 키로 인증하고 X 사용자 이름을 하나 이상 제출합니다. 게시물, 사용자 게시물, 검색, 트렌드도 같은 작업 흐름을 따릅니다.

curl -X POST "https://api.socq.ai/v1/x/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","@OpenAI"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

X API 주요 활용 사례

크리에이터·파트너 리서치

알고 있는 사용자 이름의 정보를 보강하고, 공개 계정 신호를 비교하고, 일관된 크리에이터 프로필을 구축합니다.

브랜드·시장 모니터링

선택한 계정을 팔로우하고, 고정된 검색을 반복하거나, 알고 있는 WOEID의 트렌드를 수집해 브랜드, 경쟁사, 주제에 대한 타임스탬프 데이터셋을 구축합니다.

캠페인 콘텐츠 리포팅

캠페인 게시물 URL을 확인해 콘텐츠, 작성자, 미디어, 관계, 수집 시점의 참여도를 정리합니다.

리서치와 데이터 제품

일관된 프로필·게시물 레코드를 데이터 웨어하우스, 분류기, 검색 색인, 검토 도구, 대시보드에서 활용합니다.

제한 사항과 공개 데이터 정책

SocQ는 작업이 실행되는 시점에 공개적으로 접근 가능한 X 데이터를 있는 그대로 반환합니다.

  • 프로필 카운터와 게시물 참여도는 collected_at 기준의 스냅샷입니다.
  • 검색 결과는 수집 시점에 선택한 최신순 또는 인기순 정렬을 따릅니다.
  • 트렌드 순위와 설명은 원본에서 가져오며, 수집 시점에 요청한 WOEID의 상태를 나타냅니다.
  • results_limit은 최댓값을 정하지만, 실제 반환 건수는 작업 중에 확인되는 대상 공개 레코드 수에 따라 달라집니다.
  • 이 API는 공개 데이터만 읽으며 게시물을 게시하거나 X 계정을 관리하지 않습니다.

X API 자주 묻는 질문

X API로 무엇을 수집할 수 있나요?

공개 프로필, 팔로워·팔로잉 목록, 알고 있는 게시물, 최근 게시물, 답글, 인용 게시물, 리포스트한 사용자 프로필, 검색 결과, 알고 있는 숫자 WOEID의 현재 트렌드를 가져올 수 있습니다.

어떤 X API를 선택해야 하나요?

계정에는 Profiles, Followers List, Following List를, 게시물 URL에는 Posts, Post Replies, Post Quotes, Post Retweeters를, 최근 계정 활동에는 User Posts를, 검색어 기반 탐색에는 Search를, 알고 있는 숫자 WOEID에는 Trends를 사용하세요.

작업은 어떻게 처리되나요?

POST 요청을 제출하고 /v1/tasks/{task_id}를 폴링한 뒤, data.results.items를 읽고 has_more가 true인 동안 next_cursor로 이어서 가져옵니다.

각 결과에는 무엇이 포함되나요?

결과에는 해당 API에서 제공되는 필드가 포함됩니다. 예를 들어 프로필 식별 정보, 게시물 콘텐츠와 미디어, 또는 트렌드 이름, 원본 순위, WOEID, 쿼리, 설명, 수집 시각이 있습니다.

X 지표는 실시간인가요?

아니요. 계정 카운터, 게시물 참여도, 트렌드 순위는 스냅샷입니다. 결과를 비교할 때는 collected_at을 관측 시각으로 사용하세요.

X 데이터 수집 요금은 어떻게 되나요?

Profiles는 결과 1건당 0.6 크레딧, 개별 게시물·사용자 게시물·트렌드는 0.5 크레딧, 검색 결과는 0.7 크레딧입니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.