threads/
user-posts

지원되는 프로필 URL 하나 이상에서 Threads 공개 게시물을 찾아 게시물 텍스트, 작성자 맥락, 미디어, 타임스탬프, 공개된 참여 수치를 정규화된 레코드로 반환합니다.

Threads User Posts API

프로필 URL 입력
프로필별 결과 수 제한
정규화된 공개 게시물
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Threads User Posts

Threads 사용자 게시물은 선택한 프로필 페이지에서 찾은 공개 콘텐츠로, 게시물 텍스트, 작성자 정보, 미디어 참조, 게시 시각, 공개된 참여 수치를 담고 있습니다. 이러한 레코드와 수집 타임스탬프는 계정 콘텐츠 아카이빙, 포맷 조사, 공개 참여도 비교에 활용할 수 있습니다.

Threads User Posts API 주요 기능

  • 범위가 제한된 프로필 기반 탐색Threads 공개 프로필 URL을 하나 이상 받아 results_limit을 프로필마다 따로 적용하며, 기본값은 100이고 허용 범위는 1~2,000입니다.
  • 정규화된 게시물·작성자·미디어 레코드게시물 식별자, 원본 URL, 텍스트, 제공되는 작성자 정보, 공개 미디어 참조를 일관된 결과 형식으로 반환합니다.
  • 참여 및 탐색 맥락원본 레코드에서 제공되는 경우 공개된 좋아요·댓글·리포스트·공유 수를 게시 시각, collected_at, 제출한 프로필 정보와 함께 보존합니다.

Threads User Posts API 매개변수

매개변수필수설명
urls필수threads.com 또는 threads.net의 Threads 공개 프로필 URL 목록으로, 필수 값입니다. 각 경로는 /@username 형식이어야 하며, 사용자 이름만 입력한 값, 게시물 URL, 관련 없는 경로는 거부됩니다.
results_limit선택프로필 URL마다 요청할 게시물의 최대 개수입니다. 기본값은 100이며 1~2,000 범위의 정수를 받습니다.

Threads User Posts API 사용 방법

Threads 공개 프로필 URL을 프로필별 결과 수 제한과 함께 제출하고, 비동기 작업을 따라가며, 정규화된 게시물을 커서 페이지네이션으로 읽습니다.

  1. threads.com 또는 threads.net의 /@username 경로를 사용하는 Threads 공개 프로필 URL을 하나 이상 준비합니다.
  2. urls와 선택 사항인 results_limit을 /v1/threads/user-posts로 POST하고, 반환된 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/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'

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

Threads User Posts API 추천 활용 사례

  • 선택한 프로필의 게시물 데이터셋: 정해 둔 공개 프로필 그룹에 대해 게시물 ID, 원본 URL, 텍스트, 작성자 필드, 미디어 참조, 타임스탬프, 제출한 프로필 정보를 보관합니다.
  • 콘텐츠 및 포맷 조사: 게시물 텍스트, 공개 미디어 참조, 작성자 표기, 게시 시각을 활용해 선택한 프로필들에서 반복되는 주제와 콘텐츠 포맷을 살펴봅니다.
  • 공개 참여도 비교: 프로필 컬렉션 전반의 공개된 좋아요·댓글·리포스트·공유 수를 비교하되, 각 관측값은 collected_at으로 시점을 고정합니다.

Threads User Posts API 활용 팁

  • 사용자 이름만 입력한 값, 게시물 링크, 관련 없는 경로 때문에 요청이 실패하지 않도록, 제출하기 전에 각 입력이 threads.com 또는 threads.net의 /@username 프로필 URL인지 검증하세요.
  • 제한값은 프로필마다 따로 적용되므로, 요청 깊이와 요청 전 크레딧 예상치는 urls의 개수에 results_limit을 곱한 값으로 계획하세요.
  • 후속 레코드에 제출한 프로필과 관측 시각이 남도록, 각 결과와 함께 discovery_input, input_url, collected_at을 저장하세요.
  • 텍스트, 작성자 필드, 미디어, created_at, 개별 수치는 선택 값으로 처리하세요. 하위 유형이 제공되지 않으므로 레코드가 원본 게시물인지, 답글, 인용, 리포스트인지 추정하지 마세요.

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

  • Threads Posts API — 지원되는 Threads 게시물 URL에서 공개 게시물 텍스트, 작성자 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
  • Threads Profiles 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 User Posts API — 자주 묻는 질문

Threads User Posts API는 지원되는 Threads 프로필 URL 하나 이상에서 공개 게시물 레코드를 찾아냅니다. 정규화된 게시물 텍스트, 작성자 맥락, 미디어, 타임스탬프, 공개된 참여 수치, 제출한 프로필 정보를 반환합니다.

threads.com, www.threads.com, threads.net, www.threads.net 중 한 곳의 HTTP 또는 HTTPS URL로, 경로가 /@username 형식이어야 합니다. 사용자 이름만 입력한 값, 게시물 URL, 그 밖의 경로 형식은 거부됩니다.

레코드에는 게시물 ID, URL, 텍스트, 공개 작성자 정보, 미디어 참조, 공개된 좋아요·댓글·리포스트·공유 수, created_at, collected_at, 추가 탐색 또는 입력 맥락이 포함될 수 있습니다. 선택적인 원본 값은 null이거나 비어 있을 수 있습니다.

results_limit의 기본값은 100이며 1~2,000 범위의 정수를 받습니다. 프로필 URL마다 적용되므로, URL 두 개에 results_limit 50을 지정하면 최대 100개의 게시물을 요청합니다.

아니요. 정규화된 응답에는 게시물 하위 유형이 제공되지 않습니다. 각 항목은 제출한 프로필 URL에서 찾은 공개 게시물로 취급하고, 원본 게시물인지 답글, 인용, 리포스트인지 추정하지 마세요.

반환된 게시물 레코드 1개당 0.5 SocQ 크레딧이 차감됩니다. 예상치는 urls의 개수에 results_limit을 곱해 계산하며, 결과가 비어 있으면 결과 요금이 부과되지 않습니다.