x/
post-replies

하나 이상의 X 게시물 URL에서 공개 답글을 수집하며, 답글 텍스트, 작성자, 공개된 참여 수치, 미디어, 상위 게시물 맥락을 게시물별 수량 제한 및 정렬과 함께 반환합니다.

X Post Replies API

게시물 대화
답글 정렬
상위 게시물 맥락
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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을 비동기 작업으로 제출한 뒤, 완료된 작업에서 정규화된 답글 레코드를 읽습니다.

  1. 숫자 /status/{id}가 포함된 공개 x.com 또는 twitter.com URL을 하나 이상 준비하고, relevance, latest, likes 중 정렬 방식을 고릅니다.
  2. urls, 게시물별 results_limit(20부터 2000까지 20 단위), sort_by를 /v1/x/post-replies로 POST합니다.
  3. 반환된 task_id를 저장하고, 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 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 true

X 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일 수 있는 작성자, 미디어, 수치, 관계 필드는 임의의 대체값을 만들지 말고 그대로 저장하세요.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

X Post Replies API — 자주 묻는 질문

X Post Replies API는 숫자 게시물 ID가 포함된 하나 이상의 X 게시물 URL에서 공개 답글을 수집하는 프로그래밍 인터페이스입니다. 답글 텍스트, 작성자, 공개된 참여 수치, 미디어, 타임스탬프, 상위 대화 맥락을 반환합니다.

경로에 /status/{numeric_id}가 포함된 공개 x.com 또는 twitter.com 게시물 링크를 담은, 비어 있지 않은 urls 배열을 제출합니다. 표준, www, m, mobile 호스트 형식을 사용할 수 있습니다.

results_limit의 기본값은 100이고 20부터 2000까지 20의 배수를 받으며, 상위 게시물마다 따로 적용됩니다. 대화가 요청한 상한보다 먼저 끝날 수 있습니다.

sort_by는 제출한 모든 게시물에 해당하는 공개 답글 타임라인 모드를 선택하며 기본값은 relevance입니다. 반환 순서는 선택한 수집 모드의 순서일 뿐, SocQ가 별도로 매긴 순위 점수가 아니라고 보세요.

답글에는 ID, URL, 텍스트, 언어, 공개 작성자, 공개된 수치, 미디어, 해시태그, 멘션, 게시·수집 시각이 포함될 수 있으며, 대화 및 상위 게시물 필드는 extra에 담깁니다.

제출한 상위 게시물은 해당 답글 결과에서 제외됩니다. 답글 ID는 수집 중과 작업 결과를 저장할 때 각각 중복이 제거되므로, 여러 번 나타난 답글도 하나의 레코드로 합쳐질 수 있습니다.

숨김, 삭제, 보호, 제한, 사용 불가, 연결이 끊긴 답글 가지는 공개적으로 보이지 않을 수 있습니다. 공개된 대화가 끝나거나 게시물별 요청 상한에 도달해도 수집이 멈춥니다.

아니요. 선택한 대화의 답글 게시물만 반환합니다. 인용 게시물과 게시물을 리포스트한 프로필은 별도의 X 리소스입니다.

저장된 정규화 답글 하나당 0.5 크레딧이 차감됩니다. 실제로 저장된 레코드 수를 기준으로 청구하므로, 결과가 없으면 결과 단위 요금이 없습니다.