Threads User Reposts
Threads 사용자 리포스트는 한 계정이 팔로워에게 다시 공유하기로 고른 게시물로, 각각 원래 작성자, 텍스트, 미디어, 게시 시각, 지금까지 모인 좋아요·답글·리포스트 수를 갖춘 원본 게시물입니다. 리포스트는 의도적인 지지 표시이므로 이 목록을 보면 그 계정이 누구의 목소리를 키워 주는지, 브랜드가 어떤 파트너를 홍보하는지, 어떤 콘텐츠가 커뮤니티를 타고 퍼지는지 알 수 있습니다.
Threads User Reposts API 주요 기능
- 리포스트 뒤의 원본 게시물모든 행은 리포스트된 게시물 자체이며 author 값이 원래 작성자로 설정되어 있어, 그 계정이 누구의 콘텐츠를 전달했는지 정확히 알 수 있습니다.
- 원본 게시물의 참여 지표metrics.likes_count, metrics.comments_count, metrics.shares_count 값은 원본 게시물의 좋아요, 답글, 리포스트 수로, 확산된 콘텐츠가 이미 얼마나 반응을 얻었는지 보여 줍니다.
- 프로필 링크로 받는 최근 리포스트urls 배열에는 https://www.threads.com/@shams 같은 프로필 링크를 넣으며, 프로필마다 최근 리포스트한 게시물이 약 25개까지 반환됩니다.
Threads User Reposts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | https://www.threads.com/@shams처럼 threads.com 또는 threads.net에서 /@{username} 형식으로 된 Threads 프로필 링크입니다. |
Threads User Reposts API 사용 방법
프로필 링크를 제출하고 그 계정이 리포스트한 게시물을 읽습니다.
- {"urls": ["https://www.threads.com/@shams"]}을 /v1/threads/user-reposts로 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/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@shams"]}'
# 0.5 credits per reposted post returned.Threads User Reposts API 추천 활용 사례
- 계정이 확산시키는 콘텐츠 출처 정리: 한 프로필의 리포스트에서 author.username 값별 횟수를 세어, 그 계정이 가장 자주 공유하는 크리에이터와 매체의 순위를 매깁니다.
- 브랜드가 홍보하는 파트너 파악: 브랜드 리포스트의 원래 작성자와 text 값을 검토해 브랜드가 힘을 실어 주는 협업자, 앰배서더, 매체를 찾습니다.
- 커뮤니티를 타고 퍼지는 콘텐츠 추적: 같은 분야 계정 여러 곳의 리포스트를 모아 여러 계정이 함께 공유한 게시물 id를 찾아냅니다.
Threads User Reposts API 활용 팁
- 모든 행의 author 값은 원래 작성자이므로, 각 리포스트를 어느 계정이 했는지 알아야 한다면 작업 하나에 프로필 하나만 제출하세요.
- published_at 값은 원본 게시물의 게시 시각으로 읽으세요. 리포스트된 시점을 기록하려면 정기적으로 수집하고 각 id가 처음 나타난 때를 저장합니다.
- 계정이 확산시키기로 한 게시물 아래의 대화를 보려면 행의 url 값을 Threads Post Replies API에 보내세요.
관련 API
Threads User Reposts 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 Replies API — Threads 프로필 URL로 계정이 올린 최신 공개 답글을 수집하며 답글 텍스트, 참여 지표, 미디어, 링크를 포함합니다.