# Throk API로 Threads 키워드 모니터링하기

키워드 모니터링은 보통 두 단계로 진행합니다. 먼저 `/post/search`로 **어떤 게시물**에서 이야기되고 있는지 보고, 이어서 `/post/keyword-trend`로 **언급량이 어떻게 변하는지** 봅니다.

## 1. 최근 이야기 찾기

최근 7일 동안 「珍珠奶茶」(버블티)를 언급한 대만 게시물을 좋아요 순으로 검색합니다.

```bash
curl -G 'https://premium-api.throk.ai/post/search' \
  -H 'Authorization: Bearer sk-throk-...' \
  --data-urlencode 'keywords=珍珠奶茶' \
  --data-urlencode 'language=tw' \
  --data-urlencode 'max_age_hours=168' \
  --data-urlencode 'sort=like:desc' \
  --data-urlencode 'size=20'
```

- 최신 이야기를 보려면 `sort=timestamp:desc`를 사용하세요.
- 작성자, 미디어, 리포스트 수도 함께 받으려면 `include_details=true`를 추가하세요(게시물당 2크레딧).
- 답글을 빼고 원글만 보려면 `post_type=thread`를 사용하세요(`include_details=true`와 함께 사용해야 함).

## 2. 언급량 트렌드 보기

두 키워드가 최근 30일 동안 매일 몇 번 언급되었는지 비교하고, 일별 참여 지표도 함께 받습니다.

```bash
curl -G 'https://premium-api.throk.ai/post/keyword-trend' \
  -H 'Authorization: Bearer sk-throk-...' \
  --data-urlencode 'keywords=珍珠奶茶' \
  --data-urlencode 'keywords=珍奶' \
  --data-urlencode 'days=30' \
  --data-urlencode 'include_engagement=true'
```

응답(일부):

```json
{
  "results": [
    {
      "keyword": "珍珠奶茶",
      "trend": [
        {
          "date": "2026-09-22",
          "count": 412,
          "like_count": 18230,
          "reply_count": 1640,
          "repost_count": 95,
          "reshare_count": 3120
        }
      ]
    }
  ],
  "credits_consumed": 240
}
```

- `count`: 그날 이 키워드를 언급한 게시물 수(답글 포함)
- `like_count`, `reply_count`, `repost_count`, `reshare_count`: 해당 게시물들의 좋아요 수, 답글 수, 리포스트 수(인용 포함), 공유 수 합계

하루는 대만 시간 00:00 기준으로 나뉩니다. `days`는 최대 90입니다.

## 키워드 선택 요령

키워드는 완전한 구문으로 매칭되므로 어떤 단어를 고르느냐가 결과에 직접 영향을 줍니다. 전체 규칙은 [검색 규칙](/ko/api/guides/search-rules/)을 참고하세요. 모니터링할 때 가장 자주 쓰는 요령은 다음과 같습니다.

- **다양한 표기를 모두 보내세요.** 예: `珍珠奶茶`와 `珍奶`, `減肥`와 `减肥`. `/post/search`는 한 번에 최대 30개의 키워드를 받으며, 키워드끼리는 「또는」(OR) 관계입니다.
- **영어는 완전한 단어 단위로 매칭됩니다.** `AI`로는 「OpenAI」를 찾지 못하므로, 필요하면 `OpenAI`도 목록에 넣으세요.
- **한국어는 조사를 고려하세요.** `맛집`으로는 「맛집에서」를 찾지 못하므로 자주 쓰는 변화형도 함께 넣으세요.
- **한 글자 키워드는 피하세요.** `茶`로 검색하면 「茶」가 들어간 모든 게시물이 나와 결과가 매우 지저분해집니다.

## 새 게시물이 올라오면 자동으로 알림 받기

API를 주기적으로 호출하고 싶지 않다면 [Webhook](/ko/api/webhooks/)을 설정하세요. 키워드가 포함된 게시물이 좋아요 수, 답글 수, 조회수 임계값에 도달하면 Throk이 서버로 바로 전송합니다.

## AI 어시스턴트에서 모니터링하기

MCP를 이용하면 Claude에게 바로 요청할 수 있습니다. 예:

> Throk으로 「珍珠奶茶」와 「珍奶」의 최근 30일 대만 언급량 추이를 조회하고, 좋아요 수가 가장 많은 게시물 5개를 나열해 줘.

설정 방법은 [AI 어시스턴트에서 사용하기(MCP)](/ko/api/mcp/)를 참고하세요.