ThreadsThreads 검색Threads 답글API 가이드

Threads 검색 API: 게시물·사용자 검색, 답글과 리포스트 수집

SocQ의 신규 Threads 엔드포인트 5종을 소개합니다. 키워드·해시태그 게시물 검색, 사용자 검색, 게시물 답글, 사용자 답글, 사용자 리포스트의 요청 방법과 결과당 가격을 정리했습니다.

SocQ2026년 11월 19일 업데이트약 7분 소요

SocQ의 첫 Threads 엔드포인트는 공개 프로필, 개별 게시물, 사용자 게시물을 읽었습니다. 2026-11-17에는 5개가 더 출시되었습니다. 그중 두 개는 검색으로, 키워드나 해시태그로 게시물을 찾고 이름으로 계정을 찾습니다. 나머지 세 개는 대화와 확산을 읽습니다. 게시물 아래의 답글, 계정이 다른 곳에 남긴 답글, 계정이 리포스트한 게시물입니다.

이 가이드에서는 새 엔드포인트별로 반환 데이터, 요청 형식, 가격, 적합한 사용 시점을 다룹니다. Meta의 공식 Threads API 및 다른 제공업체와의 비교는 Threads API 대안을 참고하세요.

빠른 답변: POST /v1/threads/search 또는 /search-users에는 query를, /post-replies, /user-replies, /user-reposts에는 urls에 Threads URL을 담아 Authorization: Bearer $SOCQ_API_KEY와 함께 보내세요. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 다음 data.results.items를 읽습니다. 가격은 결과당 0.30.6크레딧(크레딧당 $0.005 기준 $0.0015$0.003)이며 기본 요금은 없습니다.

새로운 Threads 엔드포인트 5종

엔드포인트반환 데이터입력가격
Search키워드나 해시태그의 상위 게시물 약 20개와 텍스트, 작성자, 좋아요, 답글, 리포스트, 미디어, 시각query게시물당 0.6크레딧($0.003)
User Search이름이나 사용자 이름과 일치하는 계정(보통 최대 10개)과 표시 이름, 아바타, 인증 여부query계정당 0.6크레딧($0.003)
Post Replies게시물 아래의 답글(게시물당 약 20개)과 작성자, 좋아요, 답글, 미디어, 시각게시물 URL답글당 0.3크레딧($0.0015)
User Replies계정의 최신 공개 답글 최대 약 25개와 참여 지표, 미디어프로필 URL답글당 0.5크레딧($0.0025)
User Reposts계정이 최근 리포스트한 게시물 최대 약 25개와 각 게시물의 원작성자프로필 URL게시물당 0.5크레딧($0.0025)

Threads 검색하기

Threads Search: 키워드나 해시태그로 게시물 찾기

Threads Search API는 앱과 같은 방식으로 Threads를 검색해 키워드나 해시태그의 상위 게시물을 반환합니다. 모든 게시물에는 텍스트, 작성자, 좋아요, 답글, 리포스트, 미디어, 게시 시각이 포함됩니다. 주제, 제품, 이벤트가 Threads에서 어떻게 이야기되는지 확인하고 그 대화를 이끄는 계정을 찾는 가장 빠른 방법입니다.

curl -X POST "https://api.socq.ai/v1/threads/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "basketball"
  }'

검색마다 Threads가 해당 검색어에 보여 주는 상위 게시물을 약 20개 반환합니다. 참여 지표는 metrics 아래의 likes_count, comments_count, shares_count에 있습니다. Search 문서를 참고하세요.

Threads User Search: 이름으로 계정 찾기

Threads User Search API는 이름이나 사용자 이름으로 계정을 찾습니다. 일치하는 계정마다 사용자 이름, 표시 이름, 프로필 URL, 아바타, 인증 상태를 반환합니다. 게시물이나 답글을 가져오기 전에 올바른 핸들인지 확인하거나, 인플루언서 리서치를 위해 이름 목록을 Threads 프로필로 바꿀 때 사용하세요.

curl -X POST "https://api.socq.ai/v1/threads/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "shams"
  }'

검색마다 Threads가 제안하는 계정을 보통 최대 10개 반환합니다. User Search 문서를 참고하세요.

대화와 리포스트 읽기

Threads Post Replies: 게시물 아래의 대화

Threads Post Replies API는 게시물 아래의 대화를 읽습니다. 각 답글에는 텍스트, 작성자, 좋아요 수와 답글 수, 첨부 미디어, 시각, 그리고 답한 게시물의 post_id가 포함됩니다. 공지에 대한 반응을 가늠하거나, 브랜드 게시물에서 고객 피드백을 모으거나, 크리에이터 오디언스 중 가장 활발한 사람들을 찾을 때 사용하세요.

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"]
  }'

게시물 URL은 /@{username}/post/{code} 형식을 사용하세요. 게시물마다 Threads가 그 아래에 보여 주는 답글을 약 20개 반환합니다. Post Replies 문서를 참고하세요.

Threads User Replies: 계정이 다른 사람과 대화하는 방식

Threads User Replies API는 계정의 최신 공개 답글을 텍스트, 좋아요, 답글, 미디어, 시각, 각 답글의 링크와 함께 반환합니다. 답글은 다듬어진 게시물보다 어조와 전문성을 더 직접적으로 드러내므로, 크리에이터를 검증하거나 대변인을 모니터링하거나 브랜드가 고객과의 대화를 어떻게 처리하는지 연구할 때 유용합니다.

curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.threads.com/@reuters"]
  }'

https://www.threads.com/@username 같은 프로필 URL을 사용하세요. 프로필마다 답글을 최대 약 25개 반환합니다. User Replies 문서를 참고하세요.

Threads User Reposts: 계정이 확산시키는 대상

Threads User Reposts API는 계정이 리포스트하기로 선택한 게시물을 반환합니다. 각 행은 원본 게시물이며 작성자, 텍스트, 참여 지표, 미디어가 포함됩니다. 리포스트 기록은 친밀도를 보여 주는 직접적인 신호입니다. 크리에이터가 신뢰하는 목소리, 브랜드가 홍보하는 파트너, 커뮤니티에서 퍼지는 콘텐츠를 파악할 수 있습니다.

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"]
  }'

프로필마다 최근 리포스트를 최대 약 25개 반환합니다. author는 리포스트한 계정이 아니라 원작성자입니다. User Reposts 문서를 참고하세요.

간단한 리서치 워크플로

  1. 제품 이름이나 해시태그로 Search를 실행해 사람들이 반응하는 게시물을 찾습니다.
  2. 반응이 가장 좋은 게시물 URL을 Post Replies에 넘겨 반응을 읽습니다.
  3. User Search로 언급된 이름을 핸들로 확인한 다음, 해당 프로필에 User Replies와 User Reposts를 실행해 어떻게 말하고 누구를 확산시키는지 확인합니다.
  4. 계정 자체의 게시물이나 프로필 정보는 기존 User Posts와 Profiles 엔드포인트를 사용하세요.

인증과 비동기 작업 흐름

모든 요청에는 API 키와 JSON 콘텐츠 유형이 포함됩니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

제출 호출마다 백그라운드 작업이 시작됩니다.

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

제출 응답은 data.task_id와 data.status를 반환합니다. 같은 키로 작업을 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

작업이 queued, running, failed 상태인 동안에는 응답에 작업 메타데이터만 들어 있으며, failed이면 error_message를 확인하세요. succeeded가 되면 같은 응답의 data.results.items에 정규화된 레코드의 첫 페이지가 포함됩니다. limit의 기본값은 50이고 최대 500까지 지정할 수 있습니다. has_more가 true이면 results.next_cursor를 cursor로 넘겨 다음 페이지를 읽습니다. fields에는 쉼표로 구분한 필드나 점 경로를 최대 50개까지 지정할 수 있습니다.

클라이언트 쪽 타임아웃은 작업을 취소하지 않습니다. 다시 제출해 중복 비용을 내지 말고 같은 task_id로 조회를 이어가세요. 제출 본문에 callback_url을 추가하면 작업이 끝났을 때 작업 요약을 담은 POST를 한 번 받을 수도 있습니다.

일반적인 작업 비용

  • 게시물 20개를 반환하는 키워드 검색 1회: 20 × 0.6 = 12크레딧, $0.06.
  • 게시물 10개 아래의 답글 각 약 20개: 200 × 0.3 = 60크레딧, $0.30.
  • 계정 10개의 답글과 리포스트 각 약 25개: 500 × 0.5 = 250크레딧, $1.25.

자주 묻는 질문(FAQ)

검색 결과 20개 이후의 페이지도 볼 수 있나요?

Search는 Threads가 해당 검색어에 보여 주는 상위 게시물을 검색당 약 20개 반환합니다. 범위를 넓히려면 관련 키워드나 해시태그를 별도의 검색으로 실행하세요.

Threads나 Instagram 로그인이 필요한가요?

아니요. 요청에는 SocQ API 키와 검색어 또는 공개 Threads URL만 들어가며, Threads 계정 자격 증명은 포함되지 않습니다.

User Reposts는 누가 리포스트했는지 보여 주나요?

프로필 하나를 대상으로 요청하므로 모든 행은 그 프로필이 리포스트한 것입니다. 각 행의 author는 원작성자입니다.

여러 프로필이나 게시물을 한 번에 보낼 수 있나요?

네. Post Replies, User Replies, User Reposts는 urls에 목록을 받으며, 결과 수는 URL마다 적용됩니다.

모든 Threads 엔드포인트와 가격은 어디에서 볼 수 있나요?

Threads 플랫폼 페이지와 요금 페이지에서 확인할 수 있습니다.

THREADS API

공개 Threads URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

Threads API 살펴보기