Threads Post Replies
Threads 게시물 답글은 게시물 아래에서 이어지는 대화로, 답글마다 자체 텍스트, 작성한 계정, 이미지나 동영상, 타임스탬프, 받은 좋아요 수와 이어진 답글 수가 담겨 있습니다. 함께 읽으면 발표에 오디언스가 실제로 어떻게 반응했는지, 어떤 질문과 불만이 나왔는지, 어떤 목소리가 가장 많은 공감을 얻었는지 드러납니다.
Threads Post Replies API 주요 기능
- 게시물 링크에서 바로 받는 답글urls 배열에 threads.com 또는 threads.net의 /@{username}/post/{code} 링크를 하나 이상 넣으면, Threads가 각 게시물 아래에 보여 주는 답글을 게시물당 20개 안팎으로 받습니다.
- 답글마다 붙는 참여 지표metrics.likes_count 값은 답글이 얻은 공감의 크기를, metrics.replies_count 값은 그 답글이 이끌어 낸 추가 토론의 양을 보여 줍니다.
- 인증 여부까지 담긴 답글 작성자author 값은 답글 작성자의 사용자 이름, 표시 이름, 프로필 url, 아바타를 제공하고, is_verified 값으로 배지 보유자를 구분합니다.
- 답글 대상 게시물과의 연결post_id 값은 답글이 속한 게시물을, url 값은 답글 자체를 가리키므로 여러 게시물을 섞어 보낸 배치도 쉽게 나누고 확인할 수 있습니다.
Threads Post Replies API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1처럼 threads.com 또는 threads.net에서 /@{username}/post/{code} 형식으로 된 Threads 게시물 링크입니다. |
Threads Post Replies API 사용 방법
게시물 링크를 제출하고 게시물마다 달린 답글을 읽어 옵니다.
- {"urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]}을 /v1/threads/post-replies로 POST하고 task_id 값을 기록합니다.
- GET /v1/tasks/{task_id}를 폴링합니다. status 값이 succeeded가 되면 답글이 준비된 것입니다.
- results.items에서 답글을 읽고, has_more 값이 true이면 results.next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/threads/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]}'
# 0.3 credits per reply; posts without replies are free.Threads Post Replies API 추천 활용 사례
- 발표에 대한 반응 측정: 출시나 뉴스 게시물 아래 답글 텍스트를 읽고 likes_count 값으로 가중치를 매겨, 오디언스가 어떤 반응에 힘을 실어 주었는지 확인합니다.
- 브랜드 게시물에서 고객 피드백 수집: 브랜드 게시물 아래 답글을 published_at 값과 함께 모아 질문, 불만, 요청을 들어오는 순서대로 기록합니다.
- 오디언스 중 가장 적극적인 사람 찾기: 크리에이터의 여러 게시물에서 author.username별 답글 횟수와 그 답글이 받은 좋아요 수를 세어, 연락해 볼 만한 단골 참여자를 찾습니다.
- 게시물별 반응 비교: 여러 게시물을 함께 제출하고 post_id 값으로 답글을 묶어 게시물마다 받은 반응의 양과 분위기를 비교합니다.
Threads Post Replies API 활용 팁
- 게시물 자체의 링크를 복사하세요. /@username 같은 프로필 주소는 여기서 거부되며, 한 계정이 다른 곳에 남긴 답글은 Threads User Replies API에서 가져옵니다.
- 게시물당 답글은 20개 안팎, 하나에 0.3 크레딧이므로 약 6 크레딧으로 잡고, 여기에 게시물 수를 곱해 배치 예산을 세우세요.
- 같은 게시물을 나중에 다시 수집할 때는 id 값으로 중복을 제거하세요. Threads가 보여 주는 답글은 실행할 때마다 겹칠 수 있습니다.
관련 API
Threads Post Replies API 외에 Threads의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Threads Posts API — 지원되는 Threads 게시물 URL에서 공개 게시물 텍스트, 작성자 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
- Threads Profiles API — 지원되는 Threads 프로필 URL에서 공개 프로필 정보, 소개글, 이미지, 웹사이트, 공개된 계정 수치, 수집 맥락을 수집합니다.
- Threads User Posts API — Threads 프로필 URL에서 공개 게시물을 찾으며, 프로필별 결과 수 제한과 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도, 출처 맥락을 포함합니다.
- Threads Search API — 키워드나 해시태그로 Threads 상위 게시물을 검색하며 텍스트, 작성자, 좋아요, 답글, 리포스트, 미디어, 게시 시각을 포함합니다.
- Threads User Search API — 이름이나 사용자 이름으로 Threads 계정을 찾고 사용자 이름, 표시 이름, 프로필 URL, 아바타, 인증 여부를 반환합니다.
- Threads User Replies API — Threads 프로필 URL로 계정이 올린 최신 공개 답글을 수집하며 답글 텍스트, 참여 지표, 미디어, 링크를 포함합니다.