x/
post-quotes

알고 있는 X 게시물 URL의 공개 인용 게시물을 코멘트, 작성자 정보, 미디어, 타임스탬프, 대화 맥락, 공개된 참여 수치와 함께 수집합니다.

X Post Quotes API

인용 코멘트
원본 게시물 정보
게시물별 수량 제한
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

X Post Quotes

X Post Quotes는 지정한 X 게시물을 인용한 공개 게시물을 수집해 작성자 정보, 인용 코멘트, 미디어, 게시 시각, 공개된 참여 수치를 반환하며, 여론 추적, 감성 분석, 확산 성과 평가에 활용할 수 있습니다.

X Post Quotes API 주요 기능

  • 인용 게시물 확장 수집공개 게시물 URL을 하나 이상 지정하면, 답글이나 단순 리포스트 프로필이 아니라 해당 원본을 인용한 공개 게시물을 수집합니다.
  • 원본별 독립 수량 제한원본 게시물마다 20개 단위로 20~2,000개의 레코드를 요청할 수 있으며, 제출한 각 게시물은 자체 제공처 커서로 진행됩니다.
  • 정규화된 코멘트 레코드인용 텍스트, 언어, 작성자 정보, 게시·수집 시각, 미디어, 엔티티, 공개된 참여 수치를 일관된 형태로 받습니다.
  • 원본 추적과 중복 제거제출한 URL과 상위 게시물 ID를 extra에 보관하며, 반복되는 인용 게시물 ID는 작업 전체에서 한 번만 저장됩니다.

X Post Quotes API 매개변수

매개변수필수설명
urls필수공개 x.com 또는 twitter.com 게시물 URL로, 필수 값입니다. 지원되는 호스트 형식이라면 /status/ 뒤에 숫자 게시물 ID가 있어야 합니다.
results_limit선택제출한 원본 게시물별 최대 수량으로, 선택 값입니다. 기본값은 100이며 20부터 2,000까지 20의 배수여야 합니다.

X Post Quotes API 사용 방법

알고 있는 공개 게시물 URL을 제출한 뒤, 비동기 작업을 폴링하고 정규화된 인용 게시물 레코드를 페이지 단위로 읽습니다.

  1. 경로에 /status/{numeric_id}가 포함된 공개 x.com 또는 twitter.com URL을 준비합니다.
  2. urls 배열을 선택 사항인 results_limit과 함께 /v1/x/post-quotes로 POST하고, task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안 next_cursor를 계속 사용합니다. 이 결과 커서는 제공처 페이지네이션과는 별개입니다.
X_POST_URL="https://x.com/OpenAI/status/1950240351547248941"

curl -X POST "https://api.socq.ai/v1/x/post-quotes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"urls\":[\"${X_POST_URL}\"],\"results_limit\":100}"

# Poll GET /v1/tasks/{task_id}?limit=50
# Follow data.results.next_cursor while data.results.has_more is true

X Post Quotes API 추천 활용 사례

  • 덧붙인 코멘트 분석: 제품 출시, 공지, 연구 링크, 캠페인 게시물을 인용하면서 공개 작성자들이 덧붙인 내용을 검토용 데이터셋으로 구축합니다.
  • 공개 확산 계정 파악: 인용 작성자와 공개된 참여 수치를 비교해, 어떤 계정의 관점이 눈에 띄는 공개 반응을 이끌었는지 찾아냅니다.
  • 인용 게시물 스냅샷 보관: 정해 둔 원본 게시물 목록에 대해 코멘트, 미디어 참조, 타임스탬프, 수집 시점의 수치를 보존합니다.

X Post Quotes API 활용 팁

  • 제출 전에 호스트 이름과 숫자 /status/ ID를 확인하세요. 프로필, 검색, 게시물이 아닌 링크는 거부됩니다.
  • results_limit은 작업 단위가 아니라 원본 게시물 단위로 계산하세요. URL 두 개에 100이면 최대 200개의 레코드가 예상됩니다.
  • 제출한 여러 원본이 같은 인용 게시물로 이어져도, 저장된 작업 결과에는 같은 인용 게시물 ID가 한 번만 나타납니다.
  • 삭제, 보호, 제한, 검색 제외된 게시물은 빠질 수 있으므로, 요청한 수량은 상한일 뿐 완전성을 보장하는 값이 아닙니다.
  • null일 수 있는 미디어, 엔티티, 대화, 참여 수치 필드는 방어적으로 저장하고, 변하는 수치를 비교할 때는 collected_at을 활용하세요.

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

  • Twitter Tweet Scraper API — x.com 또는 twitter.com 게시물 URL에서 공개 게시물 텍스트, 작성자, 참여도, 미디어, 해시태그, 멘션, 대화 관계를 가져옵니다.
  • Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
  • X Post Replies API — X 게시물 URL에서 공개 답글을 수집하며, 정렬 방식을 선택할 수 있고 답글 텍스트, 작성자, 공개된 참여도, 미디어, 상위 게시물 맥락을 포함합니다.
  • X Post Retweeters API — 알고 있는 X 또는 Twitter 게시물 URL을 리포스트한 계정의 정규화된 공개 프로필을 작업 단위로 중복 없이 수집합니다.
  • Twitter Mentions API — 지정한 계정을 멘션한 공개 게시물을 수집합니다.
  • X Community Posts API — 커뮤니티에 공유된 공개 게시물을 텍스트, 작성자, 상호작용 수와 함께 가져옵니다.

다른 플랫폼 둘러보기

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

X Post Quotes API — 자주 묻는 질문

X Post Quotes API는 알고 있는 X 게시물 URL을 인용한 공개 게시물을 수집하는 프로그래밍 인터페이스입니다. 정규화된 코멘트, 작성자, 참여 수치, 미디어, 타임스탬프, 원본 게시물 정보를 반환합니다.

경로에 /status/ 뒤로 숫자 게시물 ID가 이어지는 공개 x.com 또는 twitter.com 링크를 담은, 비어 있지 않은 urls 배열을 제공합니다.

수집 대상은 각 원본 게시물에 대해 반환되는 인용 게시물입니다. 답글과 원본을 리포스트만 한 계정은 별도의 리소스에서 다룹니다.

제출한 원본 URL마다 기본값은 100이며, 20부터 2,000까지 20의 배수를 받습니다. 사용할 수 있는 공개 결과는 요청한 상한보다 적을 수 있습니다.

제공처 페이지는 원본별로 게시물 ID 기준으로 중복이 제거되고, 저장 단계에서도 같은 정규화 인용 게시물 ID는 작업 전체에서 한 번만 저장됩니다.

작업은 제출한 URL 전체에서 요청한 결과 수마다 0.5 크레딧으로 먼저 예상 차감하고, 중복 없이 저장된 결과 하나당 0.5 크레딧으로 정산하며 사용하지 않은 선차감 크레딧은 환불합니다.