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을 제출한 뒤, 비동기 작업을 폴링하고 정규화된 인용 게시물 레코드를 페이지 단위로 읽습니다.
- 경로에 /status/{numeric_id}가 포함된 공개 x.com 또는 twitter.com URL을 준비합니다.
- urls 배열을 선택 사항인 results_limit과 함께 /v1/x/post-quotes로 POST하고, task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 trueX Post Quotes API 추천 활용 사례
- 덧붙인 코멘트 분석: 제품 출시, 공지, 연구 링크, 캠페인 게시물을 인용하면서 공개 작성자들이 덧붙인 내용을 검토용 데이터셋으로 구축합니다.
- 공개 확산 계정 파악: 인용 작성자와 공개된 참여 수치를 비교해, 어떤 계정의 관점이 눈에 띄는 공개 반응을 이끌었는지 찾아냅니다.
- 인용 게시물 스냅샷 보관: 정해 둔 원본 게시물 목록에 대해 코멘트, 미디어 참조, 타임스탬프, 수집 시점의 수치를 보존합니다.
X Post Quotes API 활용 팁
- 제출 전에 호스트 이름과 숫자 /status/ ID를 확인하세요. 프로필, 검색, 게시물이 아닌 링크는 거부됩니다.
- results_limit은 작업 단위가 아니라 원본 게시물 단위로 계산하세요. URL 두 개에 100이면 최대 200개의 레코드가 예상됩니다.
- 제출한 여러 원본이 같은 인용 게시물로 이어져도, 저장된 작업 결과에는 같은 인용 게시물 ID가 한 번만 나타납니다.
- 삭제, 보호, 제한, 검색 제외된 게시물은 빠질 수 있으므로, 요청한 수량은 상한일 뿐 완전성을 보장하는 값이 아닙니다.
- null일 수 있는 미디어, 엔티티, 대화, 참여 수치 필드는 방어적으로 저장하고, 변하는 수치를 비교할 때는 collected_at을 활용하세요.
관련 API
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 — 커뮤니티에 공유된 공개 게시물을 텍스트, 작성자, 상호작용 수와 함께 가져옵니다.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Trends API
- Twitter User Search API
- X Community 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