threads/
user-reposts

프로필 URL로 Threads 계정이 최근 리포스트한 게시물을 계정당 약 25개 수집하며, 각각 원래 작성자, 텍스트, 참여 지표, 미디어가 담긴 원본 게시물로 반환합니다.

Threads User Reposts API

프로필 URL 입력
모든 행에 원래 작성자
최근 리포스트 약 25개
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

프로필 링크를 제출하고 그 계정이 리포스트한 게시물을 읽습니다.

  1. {"urls": ["https://www.threads.com/@shams"]}을 /v1/threads/user-reposts로 POST하고 task_id 값을 저장합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. 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에 보내세요.

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로 계정이 올린 최신 공개 답글을 수집하며 답글 텍스트, 참여 지표, 미디어, 링크를 포함합니다.

다른 플랫폼 둘러보기

Threads 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Threads User Reposts API — 자주 묻는 질문

Threads User Reposts API는 프로필 URL을 입력받아 Threads 계정이 리포스트한 게시물을 수집하는 프로그래밍 인터페이스입니다. 각 리포스트를 작성자, 텍스트, 좋아요, 답글, 리포스트 수, 미디어가 담긴 원본 게시물로 반환합니다.

author 값은 항상 게시물의 원래 작성자입니다. 리포스트한 계정은 제출한 프로필입니다.

프로필마다 가장 최근에 리포스트한 게시물이 약 25개까지 반환됩니다.

반환된 게시물 하나당 0.5 크레딧이므로, 최근 리포스트가 25개인 프로필은 12.5 크레딧입니다.