Twitter User Tweets Scraper
X 계정 타임라인은 사용자 이름 하나에 연결된 최근 공개 게시물의 흐름으로, 게시 시각, 콘텐츠, 미디어, 작성자 정보, 공개된 참여 수치가 담겨 있습니다. 정해 둔 계정 집합에서 이러한 흐름을 비교하면 게시 주기, 반복되는 주제, 콘텐츠 구성의 변화를 파악할 수 있습니다.
Twitter User Tweets Scraper API 주요 기능
- 여러 사용자 이름의 타임라인맨 앞의 @는 있어도 없어도 되는 공개 X 사용자 이름을 하나 이상 제출하면, 작업에 포함된 모든 계정의 최근 게시물을 수집합니다.
- 최근 게시 활동을 깔끔하게 확인수집에서 답글을 제외하므로, 반환되는 타임라인은 계정의 최근 공개 게시 활동에 집중됩니다.
- 계정마다 별도 상한 적용results_limit은 사용자 이름마다 독립적으로 적용되며, 20부터 2,000까지 20의 배수를 받고 기본값은 20입니다.
- 계정 분석에 바로 쓸 수 있는 콘텐츠각 게시물에는 텍스트, 언어, 작성자 정보, 공개된 참여 수치, 미디어, 엔티티, 타임스탬프, 대화 관계가 포함될 수 있습니다.
- 계정 및 수집 출처 추적extra.input_username은 제출한 계정을 식별하고, collected_at은 타임라인 스냅샷을 수집한 시각을 기록합니다.
Twitter User Tweets Scraper API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
usernames | 필수 | 공개 X 사용자 이름의 목록으로, 필수 값입니다. 각 값의 맨 앞 @는 있어도 없어도 됩니다. |
results_limit | 선택 | 사용자 이름마다 따로 요청하는 최대 수량으로, 선택 값입니다. 기본값은 20이며 20부터 2,000까지 20의 배수를 받습니다. |
Twitter User Tweets Scraper API 사용 방법
관찰할 계정을 정하고 모든 계정에 같은 수집 깊이를 적용해, 최근 타임라인을 비교 가능한 레코드로 만듭니다.
- 공개 X 사용자 이름을 하나 이상 추가합니다. 맨 앞의 @는 선택 사항입니다.
- 계정별 results_limit을 20부터 2,000까지 20의 배수로 설정합니다.
- /v1/x/user-posts로 요청을 POST하고, 작업이 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 이어 붙이되, 다음 결과 페이지가 있으면 next_cursor를 사용합니다.
curl -X POST "https://api.socq.ai/v1/x/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","OpenAI"],"results_limit":40}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTwitter User Tweets Scraper API 추천 활용 사례
- 계정 워치리스트 운영: extra.input_username으로 최근 게시물을 묶어, 선택한 브랜드, 크리에이터, 경쟁사, 공공 기관의 최신 현황을 유지합니다.
- 게시 주기 비교: created_at으로 계정별 게시 빈도를 측정하고, 게시 시간대, 미디어 사용, 반복 주제의 변화를 파악합니다.
- 최근 게시물 코퍼스 구축: 텍스트, 작성자, 미디어, 엔티티, 참여 수치 필드를 합쳐 분류나 콘텐츠 검토에 쓸 계정별 데이터셋을 만듭니다.
Twitter User Tweets Scraper API 활용 팁
- 제출 전에 맨 앞의 @를 제거하고, 대소문자 구분 없이 사용자 이름의 중복을 정리하세요.
- 계정 간 활동을 비교할 때는 20의 배수로 유효한 같은 results_limit을 사용하세요.
- 계정에 따라 조건에 맞는 최근 게시물이 더 적게 반환될 수 있으므로, results_limit은 계정별 상한으로 취급하세요.
- 예약 수집 결과를 기존 타임라인 데이터셋에 추가하기 전에 게시물 id로 중복을 제거하세요.
- 게시 시간순은 created_at으로, 수집한 스냅샷이 얼마나 오래되었는지는 collected_at으로 확인하세요.
관련 API
Twitter User Tweets Scraper API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Twitter Tweet Scraper API — x.com 또는 twitter.com 게시물 URL에서 공개 게시물 텍스트, 작성자, 참여도, 미디어, 해시태그, 멘션, 대화 관계를 가져옵니다.
- X Post Quotes API — 알고 있는 게시물 URL에 대한 공개 인용 게시물을 수집하며, 코멘트, 작성자, 참여도, 미디어, 타임스탬프, 원본 게시물 맥락을 포함합니다.
- X Post Replies API — X 게시물 URL에서 공개 답글을 수집하며, 정렬 방식을 선택할 수 있고 답글 텍스트, 작성자, 공개된 참여도, 미디어, 상위 게시물 맥락을 포함합니다.
- Twitter Mentions API — 지정한 계정을 멘션한 공개 게시물을 수집합니다.
- Twitter Media Scraper API — 계정이 올린 사진·동영상·GIF 게시물을 최고 화질 미디어 파일과 함께 수집합니다.
- X User Replies API — 계정이 작성한 답글을 답글 대상 게시물과 함께 수집합니다.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters 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 Follow Checker API
- Twitter Video Transcript API