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 사용 방법
대상 사용자 이름과 선택 사항인 날짜 범위를 비동기 작업으로 제출한 뒤, 폴링하여 멘션 레코드를 가져옵니다.
- usernames에 사용자 이름을 하나 이상 지정하고, results_limit은 20의 배수(최대 2,000)로 설정합니다.
- 필요하면 start_date와 end_date를 지정해 멘션 수집 기간을 제한합니다.
- SocQ API 키와 함께 /v1/x/mentions로 POST 요청을 보냅니다.
- /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와 함께 사용하면 주요 멘션 게시물에서 이어지는 대화 스레드를 세밀하게 추적할 수 있습니다.
관련 API
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를 가져옵니다.
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community 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
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API