threads/
search

키워드나 해시태그로 Threads를 검색해 앱이 보여 주는 상위 게시물을 검색당 약 20개 받으며, 게시물마다 텍스트, 작성자, 좋아요, 답글, 리포스트, 미디어, 게시 시각을 반환합니다.

Threads Search API

키워드 또는 해시태그 검색어
Threads 순위 그대로의 상위 게시물
좋아요, 답글, 리포스트
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Threads Search

Threads 검색은 키워드나 해시태그에 대해 앱이 가장 높게 평가한 게시물을 보여 주며, 각 게시물에는 텍스트, 작성자, 게시 시각, 첨부 이미지나 동영상, 좋아요·답글·리포스트 수가 함께 담깁니다. 덕분에 주제, 제품, 이벤트가 지금 어떻게 이야기되고 있는지, 어떤 계정이 대화를 이끄는지 빠르게 파악할 수 있습니다.

Threads Search API 주요 기능

  • 검색어 하나로 받는 상위 게시물query 값에 키워드나 해시태그를 넣으면 Threads가 그 검색어에 보여 주는 상위 게시물을 앱의 순위 그대로 약 20개 받습니다.
  • 결과마다 좋아요, 답글, 리포스트metrics.likes_count, 답글 수인 metrics.comments_count, 리포스트 수인 metrics.shares_count 값으로 어떤 결과가 가장 큰 관심을 끌고 있는지 확인합니다.
  • 게시물 뒤의 계정 정보author 값은 사용자 이름, 표시 이름, 프로필 url, 아바타, is_verified 값을 제공하므로 주제를 이끄는 사람을 발언 내용과 함께 식별할 수 있습니다.
  • 미디어와 게시 시점media 배열에는 첨부 이미지나 동영상이 크기 정보와 함께 담기고, published_at 값으로 모든 게시물의 날짜를 확인해 최신성을 점검합니다.

Threads Search API 매개변수

매개변수필수설명
query필수검색할 키워드나 해시태그로, basketball이나 캠페인 해시태그 같은 값을 넣습니다. 요청 하나에 검색어 하나입니다.

Threads Search API 사용 방법

검색어를 보내고 작업이 끝나면 상위 게시물을 읽습니다.

  1. {"query": "basketball"}을 /v1/threads/search로 POST하고 반환된 task_id 값을 보관합니다.
  2. succeeded가 보고될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 게시물을 읽고, has_more 값이 true이면 results.next_cursor로 나머지를 요청합니다.
curl -X POST "https://api.socq.ai/v1/threads/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"basketball"}'

# 0.6 credits per post returned; a search with no matches is free.

Threads Search API 추천 활용 사례

  • 주제의 현재 분위기 파악: 제품, 이벤트, 이슈를 검색하고 상위 게시물의 text 값을 읽어 어떤 관점과 의견이 논의를 주도하는지 확인합니다.
  • 대화를 이끄는 목소리 식별: 결과 작성자를 게시물이 받은 좋아요와 리포스트 수로 순위를 매기고 인증 여부를 표시해 아웃리치 목록이나 관찰 목록을 만듭니다.
  • 브랜드명·해시태그 모니터링: 같은 검색어를 정기적으로 실행하고 새 게시물 id와 published_at 값을 보관하면 새로운 언급이 계속 쌓이는 기록이 됩니다.

Threads Search API 활용 팁

  • 검색 한 번에 상위 게시물이 약 20개씩 반환되므로, 넓은 주제는 제품명, 철자 변형, 관련 해시태그처럼 좁은 검색어 여러 개로 나누세요.
  • 겹치는 검색어의 결과는 id 값으로 합쳐, 두 검색에 모두 오른 게시물이 한 번만 집계되게 하세요.
  • 보고서 열 이름을 붙일 때 metrics.comments_count 값은 답글 수, metrics.shares_count 값은 리포스트 수로 읽으세요.
  • 결과 아래의 대화가 필요하면 해당 결과의 url 값을 Threads Post Replies API에 넘기세요.

Threads Search 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 User Search API — 이름이나 사용자 이름으로 Threads 계정을 찾고 사용자 이름, 표시 이름, 프로필 URL, 아바타, 인증 여부를 반환합니다.
  • Threads User Replies API — Threads 프로필 URL로 계정이 올린 최신 공개 답글을 수집하며 답글 텍스트, 참여 지표, 미디어, 링크를 포함합니다.

다른 플랫폼 둘러보기

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

Threads Search API — 자주 묻는 질문

Threads Search API는 키워드나 해시태그로 공개 Threads 게시물을 검색하는 프로그래밍 인터페이스입니다. 검색어에 대한 상위 게시물을 텍스트, 작성자, 좋아요, 답글, 리포스트, 미디어, 게시 시각과 함께 반환합니다.

키워드와 똑같이 query 값에 해시태그를 넣으면 Threads가 그 태그에 대해 순위를 매긴 게시물이 반환됩니다.

약 20개가 Threads가 해당 검색어의 상위 결과에 매긴 순서대로 반환됩니다. 최신순이 필요하면 published_at 값으로 직접 정렬하세요.

반환된 게시물 하나당 0.6 크레딧이므로 약 20개가 채워진 검색은 12 크레딧 안팎입니다.