콘텐츠로 이동
Throk 문서

Threads 데이터 API 사용법: Throk API 빠른 시작

1. API 키 발급받기

섹션 제목: “1. API 키 발급받기”

Throk 개발자 플랫폼에 로그인해 API 키 페이지에서 키 생성을 누릅니다. 키는 sk-throk-로 시작하며, 이 문서의 예시에서는 모두 sk-throk-...로 표기합니다. 사용할 때는 본인의 키로 바꾸세요.

개발자 플랫폼의 API 키 페이지: 키 생성, 계정 크레딧 잔액, 키 목록

API를 호출하려면 유효한 API 요금제가 필요합니다. 모든 키는 계정의 크레딧을 공유합니다.

2. 첫 요청 보내기

섹션 제목: “2. 첫 요청 보내기”

모든 요청은 https://premium-api.throk.ai로 보내며, 헤더에 Authorization: Bearer <API 키>를 포함합니다.

아래 요청은 최근 24시간 동안 「다이어트」를 언급한 한국어 게시물을 좋아요 수가 많은 순으로 10건 검색합니다.

터미널 창
curl -G 'https://premium-api.throk.ai/post/search' \
  -H 'Authorization: Bearer sk-throk-...' \
  --data-urlencode 'keywords=다이어트' \
  --data-urlencode 'language=ko' \
  --data-urlencode 'max_age_hours=24' \
  --data-urlencode 'sort=like:desc' \
  --data-urlencode 'size=10'

응답(일부):

{
  "content": [
    {
      "post": {
        "url": "https://threads.com/post/DaXXXXXX",
        "code": "DaXXXXXX",
        "caption": "다이어트 중에 저는 이렇게 먹어요……",
        "like_count": 842,
        "reply_count": 37,
        "post_timestamp": 1790000000
      },
      "user": null
    }
  ],
  "metadata": {
    "total_count": 1084,
    "current_page": 1,
    "page_size": 10,
    "total_pages": 109,
    "credits_consumed": 10
  }
}

total_count는 최대 10,000까지만 표시됩니다. 조건에 맞는 게시물이 10,000개를 넘어도 total_count는 10,000에 머물고, total_pages도 그에 맞춰 더 늘어나지 않습니다. 언급량을 보려면 키워드 트렌드를 사용하세요.

3. 남은 크레딧 확인하기

섹션 제목: “3. 남은 크레딧 확인하기”

개발자 플랫폼의 개요 또는 크레딧 사용 기록 페이지에서 잔액과 건별 사용 내역을 바로 확인할 수 있습니다. API로도 조회할 수 있으며, 이때 크레딧은 차감되지 않습니다.

터미널 창
curl 'https://premium-api.throk.ai/balance' \
  -H 'Authorization: Bearer sk-throk-...'
{ "credits": 48210 }

호출할 때마다 차감된 크레딧은 응답의 credits_consumed 필드에 표시됩니다. 사용 내역은 GET /balance/history로 조회할 수 있습니다.

자주 발생하는 오류

섹션 제목: “자주 발생하는 오류”
HTTP 상태 메시지 원인
401 Invalid API key 키를 잘못 입력했거나, 삭제된 키이거나, 헤더에 Bearer 접두사가 빠짐
402 Insufficient credits 크레딧 부족. 조회 전에 비용을 먼저 추정하며, 크레딧이 부족하면 실행하지 않음
400 기타 메시지 매개변수 누락, 형식 오류 또는 허용 범위 초과. 메시지에 어떤 매개변수인지 나옵니다. 예: 허용된 조회 기간을 초과한 시간

오류 응답은 항상 {"detail": "오류 메시지"} 형식입니다.

다음 단계

섹션 제목: “다음 단계”