threads/
posts

지원되는 게시물 URL에서 Threads 공개 게시물을 수집하고, 텍스트, 작성자 정보, 미디어, 게시 시각, 공개된 참여 수치를 정규화된 레코드로 반환합니다.

Threads Posts API

게시물 URL 입력
작성자 맥락
참여 스냅샷
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Threads Posts

Threads 게시물은 작성자 정보, 미디어 참조, 게시 시각, 공개된 좋아요·댓글·리포스트·공유 수를 담은 텍스트 기반의 공개 콘텐츠입니다. 이러한 레코드는 선택한 게시물 조사, 출처 검토, 콘텐츠 비교, 타임스탬프 기반 참여 분석에 활용할 수 있습니다.

Threads Posts API 주요 기능

  • 게시물 URL 직접 조회프로필 피드가 아니라, 제출한 게시물 그대로의 레코드를 얻도록 threads.com 또는 threads.net의 공개 /@username/post/{post_id} URL을 조회합니다.
  • 게시물 내용과 작성자 표기추적 가능한 레코드를 위해 게시물 식별자, 원본 URL, 텍스트와 함께 제공되는 작성자 ID, 사용자 이름, 표시 이름, 프로필 URL을 반환합니다.
  • 미디어와 공개 참여 스냅샷정규화된 미디어 참조, 게시·수집 시각, 공개된 좋아요·댓글·리포스트·공유 수를 게시물별로 한곳에 보존합니다.

Threads Posts API 매개변수

매개변수필수설명
urls필수threads.com 또는 threads.net에서 /@username/post/{post_id} 경로를 사용하는 Threads 공개 게시물 URL의 목록으로, 필수 값입니다.

Threads Posts API 사용 방법

알고 있는 Threads 공개 게시물을 제출하고, 비동기 작업을 따라가며, 정규화된 결과를 커서 페이지네이션으로 읽습니다.

  1. threads.com 또는 threads.net의 /@username/post/{post_id} 경로를 사용하는 Threads 공개 게시물 URL을 하나 이상 준비합니다.
  2. 링크를 urls로 /v1/threads/posts에 제출하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/threads/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example/post/POST_ID"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Threads Posts API 추천 활용 사례

  • 선택한 게시물 목록 정보 보강: 알고 있는 게시물 URL을 ID, 텍스트, 작성자 필드, 미디어, 타임스탬프, 원본 링크를 갖춘 레코드로 바꿔 정해 둔 데이터셋을 구성합니다.
  • 공개 콘텐츠와 작성자 표기 검토: 텍스트, 미디어 참조, 작성자 정보, 원본 URL을 활용해 선택한 게시물을 공개 출처와 함께 살펴봅니다.
  • 참여 스냅샷 비교: likes_count, comments_count, reposts_count, shares_count를 collected_at과 짝지어, 서로 다른 시점에 수집한 관측값을 비교합니다.

Threads Posts API 활용 팁

  • 프로필 페이지나 관련 없는 Threads 경로 때문에 요청이 실패하지 않도록, 제출하기 전에 각 URL이 /@username/post/{post_id} 경로인지 검증하세요.
  • 지원되는 다른 호스트 이름 때문에 같은 게시물에 중복 작업이 생기지 않도록, 일괄 요청 전에 게시물 경로 기준으로 링크의 중복을 제거하세요.
  • 이 엔드포인트는 알고 있는 게시물 URL에만 사용하세요. 프로필 피드를 탐색하거나 게시물의 답글을 펼치지 않으므로 results_limit은 생략합니다.
  • 일부만 공개된 게시물 때문에 결과 처리가 깨지지 않도록, 텍스트, 작성자 필드, 미디어, 게시 시각, 개별 수치는 선택 값으로 처리하세요.
  • 각 스냅샷을 관측한 시점이 남도록, 공개된 참여 필드와 함께 collected_at을 저장하세요.

Threads Posts API 외에 Threads의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • 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 User Reposts API — Threads 프로필 URL로 계정이 최근 리포스트한 게시물을 수집하며, 각각 작성자, 텍스트, 참여 지표, 미디어가 담긴 원본 게시물로 반환합니다.

다른 플랫폼 둘러보기

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

Threads Posts API — 자주 묻는 질문

Threads Posts API는 지원되는 Threads 공개 게시물 URL을 텍스트, 작성자 정보, 미디어, 게시 시각, 공개된 좋아요·댓글·리포스트·공유 수를 담은 정규화된 레코드로 변환합니다.

threads.com, www.threads.com, threads.net, www.threads.net 중 한 곳의 http 또는 https URL로, 경로가 /@username/post/{post_id} 형식이어야 합니다. 프로필 페이지와 그 밖의 경로 형식은 거부됩니다.

아니요. 각 입력이 제한할 피드가 아니라 특정 공개 게시물 하나를 가리키므로, 게시물 선택용 페이로드는 results_limit 없이 urls만 사용합니다.

아니요. 게시물 레코드에는 공개된 comments_count는 포함될 수 있지만, 답글 텍스트, 답글 작성자, 답글 트리는 담기지 않습니다.

공개 원본 레코드가 사용할 수 있는 값을 제공하지 않으면 텍스트, 작성자 상세, 미디어, 게시 시각, 개별 참여 수치가 비어 있을 수 있습니다.

반환된 게시물 레코드 1개당 0.5 SocQ 크레딧이 차감됩니다. 결과가 비어 있으면 결과 요금이 부과되지 않습니다.