x/
user-posts

하나 이상의 사용자 이름에서 최근 공개 X 게시물을 수집하며, 답글은 제외하고 계정별로 따로 수량 제한을 적용해 콘텐츠, 작성자, 미디어, 참여 수치, 관계 필드를 반환합니다.

Twitter User Tweets Scraper API

계정 타임라인
답글 제외
사용자별 수량 제한
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

관찰할 계정을 정하고 모든 계정에 같은 수집 깊이를 적용해, 최근 타임라인을 비교 가능한 레코드로 만듭니다.

  1. 공개 X 사용자 이름을 하나 이상 추가합니다. 맨 앞의 @는 선택 사항입니다.
  2. 계정별 results_limit을 20부터 2,000까지 20의 배수로 설정합니다.
  3. /v1/x/user-posts로 요청을 POST하고, 작업이 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Twitter User Tweets Scraper API 추천 활용 사례

  • 계정 워치리스트 운영: extra.input_username으로 최근 게시물을 묶어, 선택한 브랜드, 크리에이터, 경쟁사, 공공 기관의 최신 현황을 유지합니다.
  • 게시 주기 비교: created_at으로 계정별 게시 빈도를 측정하고, 게시 시간대, 미디어 사용, 반복 주제의 변화를 파악합니다.
  • 최근 게시물 코퍼스 구축: 텍스트, 작성자, 미디어, 엔티티, 참여 수치 필드를 합쳐 분류나 콘텐츠 검토에 쓸 계정별 데이터셋을 만듭니다.

Twitter User Tweets Scraper API 활용 팁

  • 제출 전에 맨 앞의 @를 제거하고, 대소문자 구분 없이 사용자 이름의 중복을 정리하세요.
  • 계정 간 활동을 비교할 때는 20의 배수로 유효한 같은 results_limit을 사용하세요.
  • 계정에 따라 조건에 맞는 최근 게시물이 더 적게 반환될 수 있으므로, results_limit은 계정별 상한으로 취급하세요.
  • 예약 수집 결과를 기존 타임라인 데이터셋에 추가하기 전에 게시물 id로 중복을 제거하세요.
  • 게시 시간순은 created_at으로, 수집한 스냅샷이 얼마나 오래되었는지는 collected_at으로 확인하세요.

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 — 계정이 작성한 답글을 답글 대상 게시물과 함께 수집합니다.

다른 플랫폼 둘러보기

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

Twitter User Tweets Scraper API — 자주 묻는 질문

Twitter User Tweets Scraper API는 하나 이상의 사용자 이름에서 최근 공개 X 게시물을 수집합니다. 계정별로 구분된 게시물 콘텐츠, 작성자, 참여 수치, 미디어, 엔티티, 관계, 수집 타임스탬프를 반환합니다.

usernames 배열에 공개 사용자 이름을 맨 앞의 @ 유무와 관계없이 추가합니다. 한 작업에서 여러 사용자 이름을 처리할 수 있습니다.

아니요. 사용자 이름마다 따로 적용되며 기본값은 20이고, 20부터 2,000 사이의 20의 배수여야 합니다.

수집된 계정 타임라인에서 답글은 제외되므로, 레코드는 제출한 각 사용자 이름의 그 밖의 최근 공개 게시물에 집중됩니다.

텍스트, 언어, 작성자 정보, 공개된 참여 수치, 미디어, 해시태그, 멘션, 타임스탬프, 대화 관계, 제출한 사용자 이름을 활용할 수 있습니다.

요청한 값은 수집의 최댓값입니다. 실제 개수는 작업이 실행될 때 해당 계정에서 확인할 수 있는, 조건에 맞는 최근 공개 게시물에 따라 달라집니다.

정규화된 계정 게시물 레코드 하나당 0.5 SocQ 크레딧이 사용됩니다.