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 사용 방법
사용자 이름 하나를 제출하고 미디어 탭의 게시물을 페이지 단위로 읽습니다.
- {"username": "NASA", "results_limit": 20}을 /v1/x/user-media로 POST합니다.
- status가 succeeded가 될 때까지 몇 초 간격으로 GET /v1/tasks/{task_id}를 확인합니다.
- 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가 첨부 미디어를 가리키려고 덧붙이는 링크입니다.
관련 API
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 동영상의 음성을 텍스트로 변환하고 동영상 길이도 함께 반환합니다.
- 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
- X User Replies API
- Twitter Follow Checker API