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을 비동기 작업으로 제출하고 상태를 폴링한 뒤, 중복 없는 정규화 프로필 결과를 페이지 단위로 읽습니다.
- 경로에 /status/{numeric_post_id}가 포함된 공개 x.com 또는 twitter.com URL을 하나 이상 준비합니다.
- urls와 100부터 2,000까지 100 단위의 results_limit을 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /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_cursorX Post Retweeters API 추천 활용 사례
- 확산 오디언스 발굴: 선택한 게시물을 확산시킨 것으로 확인된 공개 계정의 중복 없는 디렉터리를 만들어 조사, 검토, 아웃리치 준비에 활용합니다.
- 리포스트 계정 프로필 정보 보강: 정식 프로필, 소개글, 이미지, 공개 계정 속성, 위치, 웹사이트, 공개된 수치를 확산 데이터셋에 추가합니다.
- 게시물 간 오디언스 중복 분석: 게시물별 중복이나 출처 구분이 중요하다면 작업당 원본 게시물 하나로 실행하고, 완료된 결과 세트 사이에서 고정된 프로필 ID를 비교합니다.
X Post Retweeters API 활용 팁
- 같은 게시물이라도 URL 형식이 다르면 입력 검증 단계에서 합쳐진다는 보장이 없으므로, 일괄 제출 전에 게시 URL을 정규화하고 숫자 게시물 ID 기준으로 중복을 제거하세요.
- results_limit은 원본 게시물별 상한이지 반환 수를 보장하는 값이 아닙니다. 공개 범위와 사용 가능한 페이지네이션에 따라 프로필이 더 적게 반환될 수 있습니다.
- 정규화된 프로필 결과에는 원본 게시물 URL이나 게시물 ID가 남지 않으므로, 출처 구분이 중요하다면 작업마다 원본 URL을 하나만 사용하세요.
- 작업 결과의 불투명한 results.next_cursor는 수집 페이지네이션과 별개로 따라가세요. 공개되는 커서는 이미 저장된 정규화 결과를 넘겨 보는 용도입니다.
- 작업 간 병합에는 프로필 ID를 영구 키로 사용하고, 변하는 공개 수치는 collected_at을 기준으로 삼으세요.
- 공개 소개글, 이미지, 계정 신호, 수치, 리포스트 계정 공개 여부를 확인할 수 없을 수 있으므로 null이 가능한 프로필 필드와 빈 결과를 허용하세요.
관련 API
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 — 커뮤니티 링크에서 소개, 멤버 수, 규칙, 가입 정책을 가져옵니다.
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API