x/
article

X 아티클을 게시한 게시물 URL로 아티클 전체 본문을 가져오며, 제목, 타임라인 미리보기, 커버 이미지, 작성자, 참여 수치를 함께 반환하고 문단 구분도 유지합니다.

X Articles API

게시물 URL 입력
아티클 본문 전체
제목·미리보기·커버
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

X Articles

흔히 트위터 아티클로도 불리는 X 아티클은 Premium 구독자가 제목, 커버 이미지, 서식이 적용된 본문으로 게시하는 장문 게시물로, 타임라인에는 짧은 미리보기로 표시되고 다른 게시물처럼 좋아요, 답글, 인용, 조회수가 쌓입니다. 제목, 미리보기, 본문 전체를 이 수치들과 함께 텍스트로 보관하면 장문 콘텐츠를 아카이브하고, 요약하거나 분류하고, 아티클의 성과를 작성자의 일반 게시물과 비교할 수 있습니다.

X Articles API 주요 기능

  • URL로 아티클 게시물 조회아티클을 게시한 게시물(트윗) 링크를 x.com/{username}/status/{post_id} 형식으로 하나 이상 보내면, 아티클마다 해당 게시물의 id와 url 값을 가진 행 하나가 반환됩니다.
  • 본문 전체를 일반 텍스트로text 필드에는 문단 사이에 빈 줄을 둔 아티클 전체가 들어 있어, 문단으로 나누거나 리더, 검색 색인, 언어 모델에 바로 넘길 수 있습니다.
  • 제목, 미리보기 문구, 커버 이미지title, summary(X가 타임라인에 보여 주는 미리보기), cover_url 값이 독자가 피드에서 아티클을 처음 만나는 모습 그대로 아티클을 설명합니다.
  • 작성자와 참여 수치author에는 핸들, 표시 이름, 프로필 사진, 인증 여부가, metrics에는 좋아요, 답글, 인용, 조회수가 들어 있고, published_at 값은 아티클이 공개된 시각을 기록합니다.

X Articles API 매개변수

매개변수필수설명
urls필수/{username}/status/{post_id} 형식의 X 게시물 URL을 하나 이상 넣으며, 각각 아티클을 게시한 게시물을 가리켜야 합니다.

X Articles API 사용 방법

아티클이 담긴 게시물의 링크를 제출하고 아티클마다 행 하나를 읽습니다.

  1. {"urls": ["https://x.com/USDOL/status/2119796255089947070"]}을 /v1/x/article로 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/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/USDOL/status/2119796255089947070"]}'

# text holds the whole Article, with a blank line between paragraphs.

X Articles API 추천 활용 사례

  • 작성자의 장문 콘텐츠 아카이브: 아티클마다 title, text, cover_url, published_at, url 값을 저장해 계정이 장문으로 게시한 글의 검색 가능한 사본을 보관합니다.
  • 언어 모델로 아티클 요약: text 값을 빈 줄 기준으로 나누고 title 값을 맥락으로 붙여 요약 도구나 언어 모델에 문단을 넘기면, 긴 아티클을 짧은 요약으로 바꿀 수 있습니다.
  • 아티클과 일반 게시물 비교: 작성자 아티클의 views_count, likes_count, quotes_count 값을 일반 게시물의 같은 수치와 나란히 놓고, 오디언스가 어떤 형식을 더 읽고 퍼뜨리는지 확인합니다.
  • 공개 이후 아티클 추적: 같은 URL을 일정 간격으로 요청해 published_at 이후 며칠 동안 조회수, 답글, 인용이 어떻게 쌓이는지 기록합니다.
  • 발표문을 원문 그대로 인용: 기관, 기업, 창업자가 발표를 아티클로 게시하면 text에서 정확한 구절을 가져와 url, published_at 값과 함께 출처로 밝힙니다.

X Articles API 활용 팁

  • 어떤 게시물이 아티클인지 확실하지 않다면 한 배치로 함께 보내세요. 아티클만 행으로 반환되고 요금이 청구되며, 모두 일반 게시물인 배치는 실패 처리되고 전액 환불됩니다.
  • 미리보기와 카드에는 summary, 읽기 화면에는 text 값을 쓰세요. summary는 본문 첫 부분을 그대로 담고 있어 둘을 이어 붙이면 그 부분이 두 번 출력됩니다.
  • 아티클은 게시한 게시물의 ID인 id 값으로 저장하세요. 같은 아티클을 다시 수집하면 저장된 지표가 갱신됩니다.
  • 대시보드에 아티클 참여도를 넣을 때는 metrics.comments_count 값을 아티클 게시물에 달린 답글 수로 표시하세요.

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

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

다른 플랫폼 둘러보기

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

X Articles API — 자주 묻는 질문

X Articles API는 제목과 커버 이미지가 있는 장문 게시물인 X 아티클을, 이를 게시한 게시물 URL로 읽어 오는 프로그래밍 인터페이스입니다. 제목, 타임라인 미리보기, 본문 전체 텍스트, 커버 이미지 URL, 작성자, 좋아요·답글·인용·조회수를 반환합니다.

X 아티클은 Premium 구독자가 X에 게시할 수 있는 장문 게시물로, 제목, 커버 이미지, 서식이 적용된 본문으로 구성됩니다. 타임라인에는 짧은 미리보기가 붙은 게시물로 표시되며, 독자가 열면 전체 글을 볼 수 있습니다.

아티클을 게시한 게시물의 링크를 x.com/{username}/status/{post_id} 형식으로 사용하세요. urls 배열에 여러 링크를 한 번에 넣을 수 있고, 아티클마다 별도의 행으로 반환됩니다.

해당 게시물은 행이 반환되지 않고 요금도 청구되지 않으며, 같은 요청의 아티클은 그대로 반환됩니다. URL이 모두 아티클이 아니면 작업이 실패하고 전액 환불됩니다.

커버 이미지는 cover_url 값으로 반환됩니다. 본문 안에 삽입된 이미지는 포함되지 않으며, text 필드에는 글 내용만 담깁니다.

네. text 필드에 본문 전체가 문단 사이 빈 줄이 있는 일반 텍스트로 들어 있으므로, title 값을 맨 위 제목으로 붙여 .txt 파일로 저장하거나 Markdown 문단으로 쓸 수 있습니다.