X Post Replies
X 게시물 답글은 게시물 대화 안에서 오가는 공개 응답으로, 텍스트, 작성자 정보, 언어, 미디어, 공개된 참여 수치, 게시 시각, 상위 게시물 또는 관련 게시물 링크를 담고 있습니다. 이러한 대화 레코드는 반응 분석, 스레드 복원, 답글 모니터링, 분류용 데이터셋 준비에 활용할 수 있습니다.
X Post Replies API 주요 기능
- 알고 있는 게시물의 대화 범위공개 X 게시물 URL을 하나 이상 받아 각 URL에서 숫자 게시물 ID를 추출하고, 제출한 상위 게시물 자체는 제외한 채 답글을 반환합니다.
- 답글과 작성자 레코드저장된 응답마다 답글 ID, 정식 URL, 텍스트, 언어, 게시 시각, 정규화된 공개 작성자 정보를 반환합니다.
- 공개된 반응 신호공개된 좋아요, 답글, 리포스트, 인용, 조회, 북마크 수를 미디어, 해시태그, 멘션과 함께 보존합니다.
- 선택 가능한 타임라인 정렬제출한 모든 게시물에 relevance, latest, likes 중 하나의 정렬을 적용하며, 대화마다 별도의 결과 수 제한을 둘 수 있습니다.
- 대화 추적 가능성제출한 URL, 상위 게시물 ID, 대화 ID, 답글 대상, 원본·인용·리포스트·제한된 답글 신호를 정규화된 맥락으로 보존합니다.
X Post Replies API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 x.com 또는 twitter.com 게시물 URL의 배열로, 필수 값입니다. 각 경로에 /status/{numeric_id}가 포함되어야 하며, www, m, mobile 호스트 형식도 사용할 수 있습니다. |
results_limit | 선택 | 상위 게시물별로 요청할 최대 답글 수입니다. 기본값은 100이며 20부터 2000까지 20의 배수를 받습니다. |
sort_by | 선택 | 제출한 모든 게시물에 적용되는 답글 타임라인 정렬 방식으로, relevance, latest, likes 중 하나입니다. 기본값은 relevance입니다. |
X Post Replies API 사용 방법
알고 있는 공개 게시물 URL을 비동기 작업으로 제출한 뒤, 완료된 작업에서 정규화된 답글 레코드를 읽습니다.
- 숫자 /status/{id}가 포함된 공개 x.com 또는 twitter.com URL을 하나 이상 준비하고, relevance, latest, likes 중 정렬 방식을 고릅니다.
- urls, 게시물별 results_limit(20부터 2000까지 20 단위), sort_by를 /v1/x/post-replies로 POST합니다.
- 반환된 task_id를 저장하고, 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 data.results.items를 읽고, data.results.has_more가 true인 동안 cursor=data.results.next_cursor로 같은 작업을 계속 요청합니다.
curl -X POST "https://api.socq.ai/v1/x/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100,"sort_by":"relevance"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is trueX Post Replies API 추천 활용 사례
- 공개 반응 분석: 선택한 상위 게시물들의 답글 텍스트, 언어, 작성자, 공개된 참여 수치를 비교해 공개 대화가 어떻게 다른지 살펴봅니다.
- 대화 스레드 복원: parent_post_id, conversation_id, in_reply_to 필드, 답글 ID, 정식 URL을 활용해 저장된 응답을 공개된 스레드 맥락에 다시 연결합니다.
- 수집 실행 간 답글 모니터링: 고정된 게시물 URL 목록에 대해 예약 스냅샷마다 답글 게시 시각, collected_at, 작성자, 공개 수치를 추적합니다.
- 수동 분류용 데이터셋 준비: 답글 텍스트, 작성자 정보, 타임스탬프, URL, 공개된 참여 수치를 결합해 후속 검토 대기열에 넣을 응답 레코드를 준비합니다.
X Post Replies API 활용 팁
- 프로필이나 검색 링크 때문에 작업이 실패하지 않도록, 제출 전에 모든 URL이 허용된 X 또는 Twitter 호스트이고 숫자 /status/ ID를 포함하는지 검증하세요.
- x.com과 twitter.com URL 형식이 달라도 같은 상위 게시물을 가리킬 수 있으므로, 숫자 게시물 ID를 추출해 중복을 제거하세요.
- results_limit은 상위 게시물별로 20 단위로 정하세요. 대화 종료와 작업 단위 중복 제거를 반영하기 전 기준으로 전체 후보는 urls × results_limit에 근접할 수 있습니다.
- 수집 목적에 맞게 sort_by를 고르되, relevance, latest, likes 모드 사이의 위치를 하나의 공통 순위 점수처럼 비교하지는 마세요.
- 여러 상위 대화를 복원할 때는 작업 단위 답글 중복 제거를 고려하세요. 저장된 답글 하나에는 제출 URL과 상위 게시물 맥락이 하나씩만 유지됩니다.
- 결과가 짧거나 비어 있으면 공개 범위에 따른 결과로 받아들이고, null일 수 있는 작성자, 미디어, 수치, 관계 필드는 임의의 대체값을 만들지 말고 그대로 저장하세요.
관련 API
X Post Replies API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Twitter Tweet Scraper API — x.com 또는 twitter.com 게시물 URL에서 공개 게시물 텍스트, 작성자, 참여도, 미디어, 해시태그, 멘션, 대화 관계를 가져옵니다.
- Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
- Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
- Twitter Search API — 검색식으로 공개 게시물을 찾으며, 최신순 또는 인기순 정렬과 결과 수 제한을 지정할 수 있습니다.
- X Post Quotes API — 알고 있는 게시물 URL에 대한 공개 인용 게시물을 수집하며, 코멘트, 작성자, 참여도, 미디어, 타임스탬프, 원본 게시물 맥락을 포함합니다.
- X User Replies API — 계정이 작성한 답글을 답글 대상 게시물과 함께 수집합니다.
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community 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
- Twitter Follow Checker API
- Twitter Video Transcript API