x/
list-posts

리스트 URL로 공개 X 리스트 타임라인의 최신 게시물과 리포스트를 최신순으로 수집하며, 항목마다 텍스트, 작성자, 좋아요, 조회수, 미디어, 리포스트 표시를 반환합니다.

X List Tweets API

리스트 URL 입력
리포스트 표시
최신 게시물부터
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

X List Tweets

X 리스트 타임라인은 누군가 하나의 리스트로 묶어 둔 계정들의 트윗과 리트윗을 모은 피드로, 항목마다 텍스트, 작성자, 좋아요, 댓글, 리포스트, 조회수, 첨부 이미지나 동영상, 해시태그, 멘션이 담겨 있습니다. 이 게시물들을 함께 읽으면 엄선된 기자, 창업자, 경쟁사 그룹이 무엇을 이야기하는지 따라가고, 어떤 멤버의 게시물이 가장 많은 반응을 얻는지 보고, 그룹이 누구의 콘텐츠를 계속 돌려 공유하는지 알 수 있습니다.

X List Tweets API 주요 기능

  • 공개 리스트의 타임라인을 URL로x.com/i/lists/<id> 링크를 하나 이상 제출하면 리스트마다 타임라인이 최신순으로, 리스트당 최대 2,000개 트윗까지 반환됩니다.
  • 리포스트 표시와 원작자 구분is_repost 값이 모든 리포스트를 표시합니다. author는 그 게시물을 공유한 리스트 멤버로 유지되고, reposted_author와 reposted_post_id 값이 원작자와 원본 게시물을 가리킵니다.
  • 게시물마다 참여 수치와 미디어metrics에는 좋아요, 댓글, 공유, 조회수가, media에는 이미지나 동영상마다 URL, 썸네일, 가로·세로 크기가 들어 있습니다.
  • 해시태그와 멘션을 별도 배열로hashtags와 mentions 배열이 따로 제공되므로, 리스트에서 다루는 주제와 멤버들이 언급하는 계정을 필드에서 바로 집계할 수 있습니다.

X List Tweets API 매개변수

매개변수필수설명
urls필수https://x.com/i/lists/<numeric id> 형식의 공개 X 리스트 URL입니다. 리스트마다 타임라인이 따로 수집됩니다.
results_limit선택리스트마다 수집할 게시물 수로, 20부터 2,000까지 20의 배수를 받습니다. 기본값은 100입니다.

X List Tweets API 사용 방법

리스트 URL을 보내고 작업이 끝나기를 기다린 뒤 타임라인을 페이지 단위로 읽습니다.

  1. {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100}을 /v1/x/list-posts로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 게시물을 최신순으로 읽고, has_more가 true인 동안 results.next_cursor를 다시 보냅니다.
curl -X POST "https://api.socq.ai/v1/x/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Reposts arrive with is_repost set to true and the original creator in reposted_author.

X List Tweets API 추천 활용 사례

  • 엄선된 리스트로 담당 분야 따라가기: 기자나 애널리스트 리스트의 타임라인을 매일 아침 가져와 text, author, published_at 값을 읽고, 지난 수집 이후 그룹이 무엇을 다뤘는지 확인합니다.
  • 업계가 반응하는 게시물 순위 매기기: 원본 게시물(is_repost 값이 false)만 남기고 views_count와 likes_count 기준으로 정렬해, 어떤 멤버의 업데이트가 가장 주목받았는지 찾습니다.
  • 그룹이 띄워 주는 계정 측정: 리포스트 전체에서 reposted_author.username 값을 집계해, 리스트가 가장 자주 공유하는 외부 계정과 동료 멤버를 확인합니다.
  • 경쟁사 발표를 하나의 피드로 모으기: 경쟁 브랜드 계정을 하나의 리스트에 넣고 타임라인을 수집해, 출시 게시물, 링크, 첨부 미디어를 한꺼번에 확보합니다.
  • 커뮤니티 주제 데이터셋 구축: 리스트 게시물의 해시태그와 멘션을 published_at 기준으로 묶어, 해당 커뮤니티가 시간에 따라 어떤 주제와 계정을 이야기하는지 차트로 그립니다.

X List Tweets API 활용 팁

  • 멤버를 참여도로 순위 매기기 전에 is_repost 값으로 필터링하세요. 리포스트에는 원본 게시물의 좋아요와 조회수가 담겨 있습니다.
  • 여러 멤버가 같은 게시물을 리포스트했다면 reposted_post_id 값으로 중복을 제거해 원본마다 한 번만 집계하세요.
  • 활발한 리스트에서 원본 게시물을 넉넉히 확보하려면 results_limit 값을 올리세요. 리포스트가 타임라인의 대부분을 차지할 수 있습니다.
  • 리포스트의 텍스트는 "RT @user:"로 시작하고 mentions 배열에 해당 사용자가 포함되므로, 키워드와 멘션을 집계하기 전에 리포스트를 제외하거나 접두어를 제거하세요.
  • 정기 수집에서는 저장소에 처음 들어오는 id의 항목만 남기세요. 최신순 타임라인은 이전 수집 결과와 겹칩니다.
  • 드물게 게시하는 멤버까지 타임라인에 글을 올리는 모든 계정을 보려면 같은 리스트를 Twitter List Members API로 수집하세요.

X List Tweets 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 List Members API — 리스트 멤버를 소개글, 위치, 각종 수치가 담긴 프로필로 내보냅니다.

다른 플랫폼 둘러보기

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

X List Tweets API — 자주 묻는 질문

X List Tweets API는 공개 X 리스트의 /i/lists/ URL로 리스트 타임라인을 수집하는 프로그래밍 인터페이스입니다. 게시물이나 리포스트마다 텍스트, 작성자, 좋아요, 댓글, 공유, 조회수, 미디어, 해시태그, 멘션, 리포스트 원본을 반환합니다.

x.com에서 리스트를 열고 URL(https://x.com/i/lists/1940592907737845989 형태)을 복사해 urls 배열에 넣어 제출하세요. 게시물은 리스트 자체 타임라인과 같은 순서인 최신순으로 반환됩니다.

리스트 URL에서 /i/lists/ 뒤에 오는 숫자입니다. 제출할 때는 전체 URL을 urls 배열에 넣으세요.

네. 리스트 멤버의 리포스트도 반환되며 is_repost 값으로 표시되고, 원본 게시물의 ID는 reposted_post_id, 원작자는 reposted_author 필드에 들어 있습니다. 원본 게시물만 필요하면 is_repost 값으로 필터링하세요.

존재하지 않는 리스트를 가리키는 URL은 빈 결과를 반환합니다. 작업은 성공 처리되며 요금은 청구되지 않습니다. /i/lists/ 뒤의 숫자가 빠짐없이 들어갔는지 확인하세요.

네. 리스트 URL을 각각 urls 배열에 추가하세요. results_limit 값은 리스트마다 적용되므로, 리스트 세 개에 100이면 최대 300개 게시물을 반환할 수 있습니다.