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 사용 방법
게시물 링크를 먼저 검증한 뒤, 하나의 비동기 조회 작업으로 정확한 게시물 레코드를 가져옵니다.
- 모든 공개 x.com 또는 twitter.com URL에 /status/{numeric_id}가 포함되어 있는지 확인합니다.
- 검증을 마친 urls 배열을 /v1/x/posts로 POST하고, 반환된 task_id를 저장합니다.
- 조회가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 완료되면 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 trueTwitter 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을 함께 사용하세요.
- 다양한 형태의 게시물 레코드를 저장할 때는 미디어 배열과 답글·인용·리포스트 식별자를 선택 항목으로 취급하세요.
관련 API
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 — 지정한 계정을 멘션한 공개 게시물을 수집합니다.
- Twitter Search API
- X Followers List API
- X Following List API
- X Trends 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
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API