Threads User Replies
Threads 사용자 답글은 한 계정이 다른 사람의 스레드에 남긴 응답으로, 답글마다 자체 텍스트, 타임스탬프, 첨부 미디어, 링크, 받은 좋아요·답글·리포스트 수가 담겨 있습니다. 답글은 대표 게시물보다 빠르고 덜 다듬어진 글이라 계정의 어조, 전문성, 대화 방식이 그대로 드러나므로 크리에이터 검증, 대변인 발언 추적, 고객 응대 분석에 중요합니다.
Threads User Replies API 주요 기능
- 게시물이 아닌 답글https://www.threads.com/@reuters 같은 프로필 링크를 넣으면 그 계정이 다른 사람에게 답한 글, 즉 최신 공개 답글이 약 25개까지 반환됩니다.
- 답글별 텍스트, 미디어, 링크text 값에는 답글 내용, media 값에는 첨부 이미지나 동영상이 담기고, url 값은 Threads의 해당 스레드 안에서 답글을 열어 줍니다.
- 답글이 받은 반응metrics.likes_count, metrics.comments_count, metrics.shares_count 값은 각 답글이 받은 좋아요, 후속 답글, 리포스트 수를 보여 줍니다.
Threads User Replies API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | https://www.threads.com/@reuters처럼 threads.com 또는 threads.net에서 /@{username} 형식으로 된 Threads 프로필 링크입니다. |
Threads User Replies API 사용 방법
프로필 링크를 제출하고 계정마다 최근 답글을 읽습니다.
- {"urls": ["https://www.threads.com/@reuters"]}을 POST /v1/threads/user-replies로 보내고 task_id 값을 보관합니다.
- 작업이 성공할 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- results.items에서 답글을 읽고, has_more 값이 true이면 results.next_cursor로 다음 페이지를 불러옵니다.
curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@reuters"]}'
# 0.5 credits per reply returned.Threads User Replies API 추천 활용 사례
- 협업 전 크리에이터 검증: 크리에이터의 최근 답글 text 값을 읽고, 다듬어진 게시물 너머의 어조와 전문성, 오디언스를 대하는 태도를 판단합니다.
- 대변인의 공개 답글 추적: 경영진이나 대변인의 답글을 정기적으로 수집하고 published_at 값 기준으로 새 답글을 기록해, 대화 중에 나온 발언을 놓치지 않습니다.
- 브랜드의 고객 대화 응대 검토: 브랜드 계정의 답글을 published_at 값으로 빈도를 살피고 어떤 답글이 좋아요를 받는지 보면서, 고객 지원·커뮤니티 팀이 공개적으로 어떻게 응대하는지 파악합니다.
Threads User Replies API 활용 팁
- 게시물 링크가 아닌 프로필 링크를 사용하세요. 특정 게시물 아래에 다른 사람들이 남긴 답글은 Threads Post Replies API로 가져옵니다.
- 실행마다 계정당 최신 답글 약 25개만 다루므로, 더 긴 기록이 필요하면 정기적으로 수집하고 id 값으로 중복을 제거하세요.
- metrics.comments_count 값은 그 답글 자체가 받은 답글 수로 읽으세요. 더 긴 토론으로 번진 대화를 가려내는 신호가 됩니다.
- 답글이 무엇에 대한 응답이었는지 보려면 행의 url 값을 여세요. 링크가 스레드 안의 답글 위치를 보여 줍니다.
관련 API
Threads User Replies API 외에 Threads의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Threads Posts API — 지원되는 Threads 게시물 URL에서 공개 게시물 텍스트, 작성자 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
- Threads Profiles API — 지원되는 Threads 프로필 URL에서 공개 프로필 정보, 소개글, 이미지, 웹사이트, 공개된 계정 수치, 수집 맥락을 수집합니다.
- Threads User Posts API — Threads 프로필 URL에서 공개 게시물을 찾으며, 프로필별 결과 수 제한과 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도, 출처 맥락을 포함합니다.
- Threads Post Replies API — 게시물 URL로 Threads 게시물 아래의 답글을 수집하며 답글 텍스트, 작성자, 좋아요·답글 수, 미디어, 답글 대상 게시물 ID를 포함합니다.
- Threads Search API — 키워드나 해시태그로 Threads 상위 게시물을 검색하며 텍스트, 작성자, 좋아요, 답글, 리포스트, 미디어, 게시 시각을 포함합니다.
- Threads User Reposts API — Threads 프로필 URL로 계정이 최근 리포스트한 게시물을 수집하며, 각각 작성자, 텍스트, 참여 지표, 미디어가 담긴 원본 게시물로 반환합니다.