x/
posts

알고 있는 공개 x.com 또는 twitter.com 게시물 URL을 전체 텍스트, 작성자 정보, 참여 수치, 미디어, 엔티티, 대화 관계가 담긴 구조화된 게시물 레코드로 변환합니다.

Twitter Tweet Scraper API

알고 있는 게시물 조회
참여 수치
대화 링크
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Twitter Tweet Scraper

공개 X 게시물은 텍스트와 게시 시각에 작성자, 미디어, 해시태그, 멘션, 공개된 반응, 주변 대화로 이어지는 링크가 함께 묶여 있습니다. 알고 있는 URL에서 이런 조합을 수집하면 게시물 카탈로그, 검토용 데이터셋, 특정 시점 비교가 더 완성도 높아집니다.

Twitter Tweet Scraper API 주요 기능

  • 정확한 게시물 URL 해석경로에 숫자 게시물 ID가 포함된 공개 x.com 또는 twitter.com 링크를 하나 이상 조회합니다.
  • 게시물과 작성자 정보정식 게시물 ID와 URL, 전체 텍스트, 언어, 게시 시각, 작성자의 공개 정보와 프로필 링크를 반환합니다.
  • 참여 수치, 미디어, 엔티티좋아요, 답글, 리포스트, 인용, 조회, 북마크 수와 미디어 참조, 해시태그, 멘션을 게시물과 함께 보관합니다.
  • 대화 및 출처 정보답글, 대화, 인용, 리포스트, 출처, 제출한 URL의 식별자를 보존해 알고 있는 게시물을 계속 추적할 수 있습니다.

Twitter Tweet Scraper API 매개변수

매개변수필수설명
urls필수공개 x.com 또는 twitter.com 게시물 URL의 목록으로, 필수 값입니다. 각 URL의 /status/ 경로에 숫자 게시물 ID가 포함되어야 합니다.

Twitter Tweet Scraper API 사용 방법

게시물 링크를 먼저 검증한 뒤, 하나의 비동기 조회 작업으로 정확한 게시물 레코드를 가져옵니다.

  1. 모든 공개 x.com 또는 twitter.com URL에 /status/{numeric_id}가 포함되어 있는지 확인합니다.
  2. 검증을 마친 urls 배열을 /v1/x/posts로 POST하고, 반환된 task_id를 저장합니다.
  3. 조회가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 완료되면 data.results.items를 수집하고, has_more가 false가 될 때까지 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/x/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Twitter Tweet Scraper API 추천 활용 사례

  • 게시물 링크 카탈로그 완성: 링크만 있던 X 항목을 검색 가능한 텍스트, 작성자 정보, 미디어 참조, 엔티티, 게시 시각, 고정 게시물 ID로 채웁니다.
  • 캠페인 게시물 기록: 승인된 캠페인 URL 목록에 대해 정확한 콘텐츠, 작성자, 미디어, 관계 정보, 수집 시점의 참여 수치를 확보합니다.
  • 선택한 게시물 스냅샷 비교: 같은 게시물 ID를 정해 둔 주기로 조회하고, 좋아요·답글·리포스트·인용·조회·북마크 수를 collected_at 기준으로 비교합니다.

Twitter Tweet Scraper API 활용 팁

  • 프로필이나 검색 URL이 조회 배치에 들어가지 않도록, 제출 전에 숫자 /status/ ID가 없는 링크는 걸러 내세요.
  • x.com과 twitter.com 형식에서 게시물 ID를 추출한 뒤, 전체 URL 문자열이 아니라 그 ID를 기준으로 중복을 제거하세요.
  • 공개 수치는 조회 이후에도 계속 변하므로, 참여 수치를 비교할 때는 항상 collected_at을 함께 사용하세요.
  • 다양한 형태의 게시물 레코드를 저장할 때는 미디어 배열과 답글·인용·리포스트 식별자를 선택 항목으로 취급하세요.

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

  • Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
  • Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
  • X Post Quotes API — 알고 있는 게시물 URL에 대한 공개 인용 게시물을 수집하며, 코멘트, 작성자, 참여도, 미디어, 타임스탬프, 원본 게시물 맥락을 포함합니다.
  • X Post Replies API — X 게시물 URL에서 공개 답글을 수집하며, 정렬 방식을 선택할 수 있고 답글 텍스트, 작성자, 공개된 참여도, 미디어, 상위 게시물 맥락을 포함합니다.
  • X Post Retweeters API — 알고 있는 X 또는 Twitter 게시물 URL을 리포스트한 계정의 정규화된 공개 프로필을 작업 단위로 중복 없이 수집합니다.
  • Twitter Mentions API — 지정한 계정을 멘션한 공개 게시물을 수집합니다.

다른 플랫폼 둘러보기

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

Twitter Tweet Scraper API — 자주 묻는 질문

Twitter Tweet Scraper API는 허용된 게시물 URL마다 공개 X 게시물을 하나씩 가져옵니다. 게시물 텍스트, 작성자, 참여 수치, 미디어, 엔티티, 타임스탬프, 대화 관계를 반환합니다.

/status/ 경로에 숫자 게시물 ID가 포함된 공개 x.com 또는 twitter.com URL을 사용하세요. 허용되는 링크를 urls 배열에 하나 이상 넣으면 됩니다.

각 레코드에는 정식 식별 정보와 URL, 전체 텍스트, 언어, 작성자 정보, 참여 수치, 미디어, 해시태그, 멘션, 게시 시각, 수집 시각이 포함될 수 있습니다.

extra 객체에 사용 가능한 대화, 상위 게시물, 인용된 게시물, 리포스트된 게시물의 식별자가 담겨, 조회한 게시물을 대화 맥락과 연결합니다.

작업에서 반환된 게시물 하나당 0.5 SocQ 크레딧이 차감됩니다.