X User Replies
X(트위터) 프로필의 답글 탭에는 계정이 다른 트윗에 남긴 답글이 최신순으로 모여 있으며, 답글마다 대화와 답한 대상 게시물, 그리고 그 게시물의 작성자와 텍스트에 연결되어 있습니다. 답글과 대상 게시물을 나란히 보면 계정이 누구와 대화하는지, 메인 타임라인 밖에서 무엇을 말하는지, 질문과 비판에 어떻게 대응하는지 알 수 있습니다.
X User Replies API 주요 기능
- 한 계정이 작성한 답글사용자 이름을 보내면(맨 앞의 @는 선택) 그 계정이 게시한 답글을 답글 탭에서 읽어 최신순으로 받습니다.
- 답한 게시물을 같은 행에in_reply_to 필드에 답글이 응답한 게시물의 id, url, text, author, published_at 값이 들어 있어, 모든 주고받음을 결과에서 바로 읽을 수 있습니다.
- 대화 ID와 상위 게시물 IDconversation_id와 in_reply_to_id 값이 답글을 스레드와 바로 위 게시물에 연결해 주므로, 대화별로 답글을 묶을 수 있습니다.
- 답글 텍스트, 미디어, 참여 수치답글마다 텍스트, 첨부 이미지나 동영상, 좋아요·댓글·공유·조회수가 함께 제공됩니다.
X User Replies API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
username | 필수 | 답글을 수집할 X 사용자 이름이며, 맨 앞의 @는 있어도 없어도 됩니다. |
results_limit | 선택 | 반환할 답글 수로, 1부터 1,000 사이 값입니다. 기본값은 20입니다. |
X User Replies API 사용 방법
사용자 이름 하나를 제출하고 답글을 대상 게시물과 함께 읽습니다.
- {"username": "elonmusk", "results_limit": 20}을 /v1/x/user-replies로 POST합니다.
- status가 succeeded로 바뀔 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- results.items에서 답글을 읽고(대상 게시물은 in_reply_to 필드), has_more가 true인 동안 results.next_cursor를 넘깁니다.
curl -X POST "https://api.socq.ai/v1/x/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"elonmusk","results_limit":20}'
# in_reply_to holds the post each reply answers: its text, author, url and publish time.X User Replies API 추천 활용 사례
- 계정의 대화 상대 파악: 계정의 답글 전체에서 in_reply_to.author.username 값을 집계해 가장 자주 소통하는 사람과 브랜드를 정리합니다.
- 브랜드 고객 응대 답글 점검: 답글의 text를 in_reply_to.text 값과 나란히 읽고 published_at에서 in_reply_to.published_at 값을 빼서, 고객 지원 계정이 얼마나 빠르고 적절하게 응답하는지 측정합니다.
- 공인이 답글에서 하는 말 추적: 경영진이나 정치인의 답글을 정기적으로 수집해 대화 속에서 나온 발언을 포착하고, url 값을 출처 링크로 보관합니다.
- 분석용 게시물·답글 쌍 구축: in_reply_to.text와 text 값을 짝지어, 계정의 응답 방식을 어조, 입장, 주제별로 연구하는 대화 데이터셋을 만듭니다.
X User Replies API 활용 팁
- 감성이나 길이를 측정하기 전에 text 맨 앞의 @핸들을 지우세요. 답글은 답하는 대상 계정의 핸들로 시작합니다.
- conversation_id 값으로 답글을 묶으면 계정이 한 스레드에 남긴 메시지를 모두 볼 수 있습니다.
- in_reply_to.text나 작성자가 비어 있으면 답글은 그대로 두고 in_reply_to.url 값을 저장해, 나중에 대상 게시물을 조회할 수 있게 하세요.
- 계정의 게시물에 다른 사람들이 단 답글이 필요하면 게시물 URL로 X Post Replies API를 사용하세요. X User Replies API는 계정이 직접 작성한 답글을 다룹니다.
관련 API
X User Replies API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Twitter Tweet Scraper API — x.com 또는 twitter.com 게시물 URL에서 공개 게시물 텍스트, 작성자, 참여도, 미디어, 해시태그, 멘션, 대화 관계를 가져옵니다.
- Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
- Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
- Twitter Search API — 검색식으로 공개 게시물을 찾으며, 최신순 또는 인기순 정렬과 결과 수 제한을 지정할 수 있습니다.
- X Post Replies API — X 게시물 URL에서 공개 답글을 수집하며, 정렬 방식을 선택할 수 있고 답글 텍스트, 작성자, 공개된 참여도, 미디어, 상위 게시물 맥락을 포함합니다.
- X Thread Context API — 게시물과 함께 답글 체인의 이전 글, 공개 답글, 관계 ID를 가져옵니다.
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts 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
- Twitter Follow Checker API
- Twitter Video Transcript API