x/
post-retweeters

알고 있는 X 또는 Twitter 게시물을 리포스트한 계정의 정규화된 공개 프로필을 수집하며, 작업 단위 중복 제거, 공개된 계정 신호, 프로필 수치를 제공합니다.

X Post Retweeters API

리포스트 오디언스
공개 프로필
작업 단위 중복 제거
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

X Post Retweeters

X Post Retweeters 레코드는 알고 있는 X 또는 Twitter 게시물 URL을 리포스트한 것으로 확인된 공개 계정을 식별하고, 프로필 정보, 공개된 계정 신호, 공개 수치, 수집 시각을 정규화합니다. 여러 원본 게시물은 각각 독립적으로 순회한 뒤 저장된 프로필을 작업 전체에서 중복 제거하므로, 각 결과에는 원본 게시물 정보가 남지 않습니다.

X Post Retweeters API 주요 기능

  • 게시물 URL 해석공개 x.com 및 twitter.com 게시물 URL을 받아, 공개된 리포스트 계정 목록을 수집하는 데 필요한 숫자 게시물 식별자를 추출합니다.
  • 정규화된 계정 프로필프로필 ID, 사용자 이름, 표시 이름, 정식 프로필 URL, 소개글, 아바타, 커버, 공개 계정 속성을 확인할 수 있는 범위에서 반환합니다.
  • 공개된 프로필 수치확인 가능한 팔로워·팔로잉·게시물·미디어·좋아요 수를 계정 생성 시각 및 수집 시각과 함께 가져옵니다.
  • 중복 없는 다중 게시물 결과 세트제출한 게시물마다 별도의 결과 상한으로 순회한 뒤, 완료된 작업 전체에서 정규화된 프로필을 한 번만 저장합니다.

X Post Retweeters API 매개변수

매개변수필수설명
urls필수숫자 게시물 ID가 포함된 공개 x.com 또는 twitter.com 게시물 URL로, 필수 값입니다. 여러 개는 쉼표나 줄바꿈으로 구분합니다.
results_limit선택원본 게시물마다 독립적으로 요청할 최대 프로필 수입니다. 기본값은 100이며 100부터 2,000까지 100의 배수를 받습니다.

X Post Retweeters API 사용 방법

알고 있는 공개 게시물 URL을 비동기 작업으로 제출하고 상태를 폴링한 뒤, 중복 없는 정규화 프로필 결과를 페이지 단위로 읽습니다.

  1. 경로에 /status/{numeric_post_id}가 포함된 공개 x.com 또는 twitter.com URL을 하나 이상 준비합니다.
  2. urls와 100부터 2,000까지 100 단위의 results_limit을 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50을 읽고, results.has_more가 true인 동안 results.next_cursor를 전달합니다.
curl -X POST "https://api.socq.ai/v1/x/post-retweeters" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

X Post Retweeters API 추천 활용 사례

  • 확산 오디언스 발굴: 선택한 게시물을 확산시킨 것으로 확인된 공개 계정의 중복 없는 디렉터리를 만들어 조사, 검토, 아웃리치 준비에 활용합니다.
  • 리포스트 계정 프로필 정보 보강: 정식 프로필, 소개글, 이미지, 공개 계정 속성, 위치, 웹사이트, 공개된 수치를 확산 데이터셋에 추가합니다.
  • 게시물 간 오디언스 중복 분석: 게시물별 중복이나 출처 구분이 중요하다면 작업당 원본 게시물 하나로 실행하고, 완료된 결과 세트 사이에서 고정된 프로필 ID를 비교합니다.

X Post Retweeters API 활용 팁

  • 같은 게시물이라도 URL 형식이 다르면 입력 검증 단계에서 합쳐진다는 보장이 없으므로, 일괄 제출 전에 게시 URL을 정규화하고 숫자 게시물 ID 기준으로 중복을 제거하세요.
  • results_limit은 원본 게시물별 상한이지 반환 수를 보장하는 값이 아닙니다. 공개 범위와 사용 가능한 페이지네이션에 따라 프로필이 더 적게 반환될 수 있습니다.
  • 정규화된 프로필 결과에는 원본 게시물 URL이나 게시물 ID가 남지 않으므로, 출처 구분이 중요하다면 작업마다 원본 URL을 하나만 사용하세요.
  • 작업 결과의 불투명한 results.next_cursor는 수집 페이지네이션과 별개로 따라가세요. 공개되는 커서는 이미 저장된 정규화 결과를 넘겨 보는 용도입니다.
  • 작업 간 병합에는 프로필 ID를 영구 키로 사용하고, 변하는 공개 수치는 collected_at을 기준으로 삼으세요.
  • 공개 소개글, 이미지, 계정 신호, 수치, 리포스트 계정 공개 여부를 확인할 수 없을 수 있으므로 null이 가능한 프로필 필드와 빈 결과를 허용하세요.

X Post Retweeters API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Twitter Tweet Scraper API — x.com 또는 twitter.com 게시물 URL에서 공개 게시물 텍스트, 작성자, 참여도, 미디어, 해시태그, 멘션, 대화 관계를 가져옵니다.
  • Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
  • X Followers List API — X 사용자 이름 하나 이상에 대해 공개 팔로워 계정 정보와 공개된 프로필 지표를 수집합니다.
  • X Following List API — 공개 X 계정이 팔로우하는 프로필을 수집하며, 계정 정보, 소개글, 계정 신호, 공개된 카운터, 출처 사용자 이름을 포함합니다.
  • X Post Quotes API — 알고 있는 게시물 URL에 대한 공개 인용 게시물을 수집하며, 코멘트, 작성자, 참여도, 미디어, 타임스탬프, 원본 게시물 맥락을 포함합니다.
  • X Community API — 커뮤니티 링크에서 소개, 멤버 수, 규칙, 가입 정책을 가져옵니다.

다른 플랫폼 둘러보기

X 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

X Post Retweeters API — 자주 묻는 질문

X Post Retweeters API는 알고 있는 하나 이상의 X 또는 Twitter 게시물을 리포스트한 것으로 확인된 계정의 정규화된 공개 프로필 레코드를 가져옵니다.

x.com, www.x.com, m.x.com, mobile.x.com, twitter.com, www.twitter.com, m.twitter.com, mobile.twitter.com 중 한 곳의 http 또는 https URL이며, 경로에 /status/{numeric_post_id}가 포함되어야 합니다.

상한은 원본 게시물마다 독립적으로 적용되며 기본값은 100이고, 100부터 2,000 사이의 100의 배수여야 합니다.

결과에는 프로필 ID, 사용자 이름, 이름, 정식 URL, 소개글, 아바타, 커버, 인증·비공개 신호, 공개된 수치, 계정 생성 시각, 수집 시각, 그 밖의 공개 계정 신호가 포함될 수 있습니다.

아니요. 결과는 확인된 리포스트 계정의 정규화된 프로필 레코드이며, 리포스트 객체, 덧붙인 코멘트, 인용 게시물 내용은 포함하지 않습니다.

아니요. 프로필은 작업 전체에서 중복이 제거되며, 정규화된 레코드에는 원본 게시물 URL이나 ID가 남지 않습니다. 출처가 필요하면 작업마다 게시물 하나만 제출하세요.

results_limit은 상한입니다. 게시물의 공개 리포스트 계정이 더 적을 수 있고, 수집 페이지네이션이 끝났거나 사용할 수 없는 계정이 빠졌을 수 있으며, 같은 프로필은 작업 전체에서 한 번만 저장됩니다.

최종 사용량은 중복 없이 저장된 프로필 하나당 0.5 크레딧이며 기본 요금은 없습니다. 선차감 예상치는 제출한 URL 수와 게시물별 results_limit으로 계산하고, 결과가 없으면 0 크레딧입니다.