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 사용 방법
검색어를 보내고 작업이 끝나면 상위 게시물을 읽습니다.
- {"query": "basketball"}을 /v1/threads/search로 POST하고 반환된 task_id 값을 보관합니다.
- succeeded가 보고될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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에 넘기세요.
관련 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로 계정이 올린 최신 공개 답글을 수집하며 답글 텍스트, 참여 지표, 미디어, 링크를 포함합니다.