x/
user-media

사용자 이름으로 X 계정의 미디어 탭을 수집해 사진, 동영상, GIF 게시물을 최신순으로 가져오며, 캡션, 좋아요, 조회수, 파일 직접 링크를 반환하고 동영상은 최고 비트레이트 MP4로 제공합니다.

Twitter Media Scraper API

사용자 이름 입력
사진·동영상·GIF
최고 비트레이트 MP4
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Twitter Media Scraper

X(트위터) 프로필의 미디어 탭에는 계정이 사진, 동영상, GIF를 공유한 트윗이 최신순으로 모여 있으며, 게시물마다 캡션과 좋아요, 답글, 리포스트, 조회수가 함께 있습니다. 이 게시물들을 하나의 피드로 읽으면 계정이 시각적으로 무엇을 발행하는지, 어떤 클립이 가장 많이 조회되는지, 이미지와 동영상 활용이 시간에 따라 어떻게 달라지는지 알 수 있습니다.

Twitter Media Scraper API 주요 기능

  • 사용자 이름 하나로 미디어 탭 수집사용자 이름 하나를 보내면(맨 앞의 @는 선택) 사진, 동영상, GIF가 담긴 계정의 트윗을 미디어 탭 순서대로 최신순으로 받습니다.
  • 최고 비트레이트 동영상 파일동영상의 media.url 값은 최고 비트레이트 MP4를, thumbnail_url 값은 미리보기 이미지를 가리키므로 X가 제공하는 최고 화질로 클립을 저장할 수 있습니다.
  • 게시물의 첨부 파일을 한 목록에media 배열에 게시물의 이미지와 동영상이 유형과 함께 모두 담겨, 사진 여러 장이 있는 게시물도 하나의 캡션 아래 함께 유지됩니다.
  • 게시물별 캡션, 링크, 참여 수치각 게시물에는 text, url, published_at, author 값과 좋아요, 댓글, 공유, 조회수가 함께 담겨, 모든 파일을 원래 게시물과 연결해 줍니다.

Twitter Media Scraper API 매개변수

매개변수필수설명
username필수미디어 탭을 수집할 X 사용자 이름이며, 맨 앞의 @는 있어도 없어도 됩니다.
results_limit선택반환할 미디어 게시물 수로, 1부터 1,000 사이 값입니다. 기본값은 20입니다.

Twitter Media Scraper API 사용 방법

사용자 이름 하나를 제출하고 미디어 탭의 게시물을 페이지 단위로 읽습니다.

  1. {"username": "NASA", "results_limit": 20}을 /v1/x/user-media로 POST합니다.
  2. status가 succeeded가 될 때까지 몇 초 간격으로 GET /v1/tasks/{task_id}를 확인합니다.
  3. results.items에서 게시물을 읽고 media.url 파일을 각각 다운로드하며, has_more가 true인 동안 results.next_cursor로 다음 페이지를 요청합니다.
curl -X POST "https://api.socq.ai/v1/x/user-media" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"NASA","results_limit":20}'

# For a video, media.url is the highest-bitrate MP4 and thumbnail_url its preview.

Twitter Media Scraper API 추천 활용 사례

  • 계정의 사진과 동영상 아카이브: media.url 파일을 모두 다운로드하고 게시물의 url, published_at 값과 함께 정리해, 계정이 공유한 콘텐츠를 날짜별 사본으로 보관합니다.
  • 가장 많이 본 클립 찾기: media 유형이 video인 게시물만 남기고 views_count와 likes_count 기준으로 순위를 매겨 성과가 가장 좋은 클립을 고릅니다.
  • 브랜드의 시각 콘텐츠 구성 점검: published_at과 media.type 값으로 월별 이미지·동영상 게시물 수를 세어, 브랜드의 사진과 동영상 비중이 어떻게 바뀌는지 확인합니다.
  • 보고서와 브리프용 이미지 확보: thumbnail_url과 이미지 링크를 게시물 캡션, 조회수와 함께 활용해 경쟁사 리뷰나 캠페인 결산 자료를 꾸밉니다.

Twitter Media Scraper API 활용 팁

  • 저장 파일 이름은 게시물 id와 media 배열 안의 첨부 순서로 지으세요. 사진이 여러 장인 게시물도 순서가 유지됩니다.
  • 아카이브를 갱신할 때는 results_limit 값을 작게 잡고, 이미 가진 게시물 id가 나오면 페이지 넘기기를 멈추세요. 최신 게시물이 먼저 나옵니다.
  • 레이아웃에 정확한 크기가 필요하면 다운로드한 파일에서 가로·세로 크기를 측정하세요.
  • 캡션을 분석하기 전에 text 끝의 https://t.co 링크를 지우세요. X가 첨부 미디어를 가리키려고 덧붙이는 링크입니다.

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

  • Twitter Tweet Scraper API — x.com 또는 twitter.com 게시물 URL에서 공개 게시물 텍스트, 작성자, 참여도, 미디어, 해시태그, 멘션, 대화 관계를 가져옵니다.
  • Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
  • X Post Quotes API — 알고 있는 게시물 URL에 대한 공개 인용 게시물을 수집하며, 코멘트, 작성자, 참여도, 미디어, 타임스탬프, 원본 게시물 맥락을 포함합니다.
  • X Post Replies API — X 게시물 URL에서 공개 답글을 수집하며, 정렬 방식을 선택할 수 있고 답글 텍스트, 작성자, 공개된 참여도, 미디어, 상위 게시물 맥락을 포함합니다.
  • Twitter Mentions API — 지정한 계정을 멘션한 공개 게시물을 수집합니다.
  • Twitter Video Transcript API — X 동영상의 음성을 텍스트로 변환하고 동영상 길이도 함께 반환합니다.

다른 플랫폼 둘러보기

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

Twitter Media Scraper API — 자주 묻는 질문

Twitter Media Scraper API는 사용자 이름으로 X 계정의 미디어 탭에 있는 사진, 동영상, GIF 게시물을 수집하는 프로그래밍 인터페이스입니다. 게시물마다 텍스트, 작성자, 참여 수치, 파일 직접 URL이 담긴 media 목록을 반환하며, 동영상은 최고 비트레이트 MP4로 제공합니다.

계정의 사용자 이름을 제출하고 필요한 깊이만큼 results_limit 값을 정한 뒤, 반환된 게시물의 media.url 파일을 각각 다운로드하세요. 모든 파일은 url, published_at 값으로 원래 게시물과 연결됩니다.

동영상마다 media.url 값은 제공되는 MP4 중 비트레이트가 가장 높은 파일이고, thumbnail_url 값은 미리보기 이미지입니다.

네. GIF가 담긴 게시물도 미디어 탭에 속하므로 사진, 동영상 게시물과 함께 같은 최신순으로 반환됩니다.

results_limit 값으로 1~1,000개 사이에서 정하며 기본값은 20입니다. 결과는 페이지 단위로 제공되므로 has_more가 true인 동안 next_cursor로 계속 읽으세요.

요청 하나에 사용자 이름 하나를 받습니다. 계정마다 요청을 보내고 결과를 author.username 값으로 합치세요.