x/
mentions

대상 사용자 핸들을 멘션한 공개 게시물을 수집하며, 날짜 범위 필터와 참여 수치를 지원합니다.

Twitter Mentions API

브랜드 멘션
유입되는 반응
멘션 모니터링
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Twitter Mentions

공개 멘션을 추적하면 X 전반에서 브랜드 인식, 고객 문의, 유입되는 대화 반응을 파악할 수 있습니다. 정규화된 멘션 레코드에는 게시물 텍스트, 작성자 핸들, 타임스탬프, 첨부 미디어, 공개된 참여 수치가 담기며, 플랫폼 인증은 필요하지 않습니다.

Twitter Mentions API 주요 기능

  • 공개 멘션 추적대상 계정의 로그인 정보 없이도 원하는 대상 사용자 이름을 멘션한 공개 게시물을 가져옵니다.
  • 날짜 구간 지정ISO 날짜 또는 Unix 초 형식의 start_date와 end_date 필터로 멘션 피드의 범위를 제한합니다.
  • 작성자와 게시물 상세 정보게시물 전체 텍스트, 작성자 프로필, 첨부 미디어, 고유 링크가 담긴 정규화된 게시물 레코드를 받습니다.
  • 참여 수치발견된 멘션마다 좋아요, 댓글, 리포스트, 인용, 북마크, 조회 수를 추출합니다.

Twitter Mentions API 매개변수

매개변수필수설명
usernames필수멘션을 조회할 공개 X 사용자 이름의 배열입니다. 맨 앞의 @는 있어도 없어도 됩니다.
results_limit선택사용자 이름별로 반환할 최대 멘션 수입니다. 20부터 2,000 사이의 20의 배수여야 합니다.
start_date선택선택 사항인 시작 시각으로, ISO 형식(YYYY-MM-DD) 또는 Unix 초를 사용합니다. 이 시각 이후(해당 시각 포함)의 멘션만 가져옵니다.
end_date선택선택 사항인 종료 시각으로, ISO 형식(YYYY-MM-DD) 또는 Unix 초를 사용합니다. 이 시각 이전의 멘션만 가져옵니다.

Twitter Mentions API 사용 방법

대상 사용자 이름과 선택 사항인 날짜 범위를 비동기 작업으로 제출한 뒤, 폴링하여 멘션 레코드를 가져옵니다.

  1. usernames에 사용자 이름을 하나 이상 지정하고, results_limit은 20의 배수(최대 2,000)로 설정합니다.
  2. 필요하면 start_date와 end_date를 지정해 멘션 수집 기간을 제한합니다.
  3. SocQ API 키와 함께 /v1/x/mentions로 POST 요청을 보냅니다.
  4. /v1/tasks/{task_id}를 폴링하고, next_cursor로 data.results.items를 페이지 단위로 읽습니다.
curl -X POST "https://api.socq.ai/v1/x/mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@OpenAI"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Twitter Mentions API 추천 활용 사례

  • 브랜드 평판 모니터링: 회사 핸들을 향한 멘션, 리뷰, 감성 반응을 거의 실시간으로 추적합니다.
  • 고객 지원 분류: 지원 계정으로 들어온 고객 불만, 제품 버그, 피드백 중 아직 응대하지 않은 건을 찾아냅니다.
  • 경영진 계정 반응 파악: 경영진 계정을 향한 멘션과 답글을 모니터링해 발표에 대한 업계의 반응을 가늠합니다.

Twitter Mentions API 활용 팁

  • results_limit은 상위 제공처의 페이지 크기에 맞추기 위해 20의 배수(예: 20, 40, 100)여야 합니다.
  • 2026-09-01 같은 ISO 날짜 문자열은 백엔드에서 UTC 기준 Unix 타임스탬프로 자동 변환됩니다.
  • 이 엔드포인트는 해당 계정을 멘션한 게시물을 반환합니다. 계정 본인이 올린 게시물이 필요하면 X User Posts를 사용하세요.
  • X Post Replies와 함께 사용하면 주요 멘션 게시물에서 이어지는 대화 스레드를 세밀하게 추적할 수 있습니다.

Twitter Mentions 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 Community Posts API — 커뮤니티에 공유된 공개 게시물을 텍스트, 작성자, 상호작용 수와 함께 가져옵니다.
  • X Thread Context API — 게시물과 함께 답글 체인의 이전 글, 공개 답글, 관계 ID를 가져옵니다.

다른 플랫폼 둘러보기

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

Twitter Mentions API — 자주 묻는 질문

Twitter Mentions API는 X에서 지정한 사용자 핸들을 멘션한 공개 게시물을 수집합니다. 선택 사항인 날짜 범위 안에서 정규화된 게시물 데이터, 작성자 정보, 타임스탬프, 참여 수치를 반환합니다.

아니요. 이 엔드포인트는 공개 사용자 이름만으로 공개된 멘션을 조회하므로, 고객 계정의 OAuth나 사용자 로그인 토큰이 필요하지 않습니다.

상위 데이터 제공처가 멘션을 20개씩 고정된 페이지 단위로 전달하므로, 요청도 이 묶음 단위에 맞춰야 합니다.