# Throk API·MCP 업데이트 내역

Throk API(`premium-api.throk.ai`)와 MCP 도구의 업데이트 내역입니다. 최신 항목이 맨 위에 있습니다. **MCP** 표시가 있는 항목은 해당 MCP 도구에도 적용됩니다.

## 2026-09-23 · 1.9.1

- **수정**: 인기 게시물(`/post/hot`, MCP `get_hot_posts`)에 결과가 없으면 크레딧을 차감하지 않습니다.
- **수정**: `/post/search`의 `total_pages`를 올림으로 계산합니다. 마지막 페이지가 한 페이지에 못 미쳐도 총 페이지 수에 포함됩니다.
- **수정**: Webhook 이벤트에 서명이 붙습니다. `X-Throk-Signature` 헤더에 `v1`이 포함되며, [서명 검증](/ko/api/webhooks/#서명-검증) 방법으로 요청이 Throk에서 왔는지 확인할 수 있습니다. 이전 이벤트에는 타임스탬프 `t`만 있었습니다.
- **수정**: 조회수 기준만 설정한 인기 기준 Webhook 규칙이 발동하지 않던 문제를 수정했습니다. 지역을 `tw` 또는 `cn`으로 설정해도 사용할 수 있습니다.
- **안내**: Webhook은 이벤트 1건 전송당 20크레딧을 차감합니다. 수신 측 응답 성공 여부와 관계없이 전송 시점에 차감됩니다.

## 2026-09-22 · 1.9.0

- **새 기능**: 키워드 트렌드(`/post/keyword-trend`, MCP `get_keyword_trend`)에 `include_engagement` 매개변수가 추가되었습니다. 일별 게시물 수와 함께 해당 게시물들의 좋아요 수, 답글 수, 리포스트 수, 공유 수 합계도 반환합니다. 사용하면 키워드당 하루 4크레딧(기존 3크레딧)이며, 사용하지 않으면 응답과 요금 모두 이전과 같습니다.
- **개선**: 대량의 계정 일괄 조회가 다른 실시간 조회를 느리게 만들지 않습니다.

## 2026-09-17 · 1.8.3

- **새 기능**: `/post/search`와 MCP `search_posts`에 `min_age_hours`, `max_age_hours`가 추가되어 「게시 후 몇 시간」으로 검색 범위를 바로 지정할 수 있습니다(최대 90일).
- **개선**: `/post/{code}/chain`이 실시간으로 수집한 답글을 합쳐 반환하므로, 아직 수집되지 않은 게시물도 조회할 수 있습니다.
- **개선**: `/user`와 계정 일괄 조회에서 데이터가 부족하면 실시간 계정 데이터를 사용합니다.

## 2026-09-17 · 1.8.2

- **개선**: `/live/posts` 응답에 `media_url`과 `reshare_count`가 추가되었습니다. MCP `get_live_posts`는 항상 미디어 URL을 반환합니다.

## 2026-09-10 · 1.8.1

- **개선**: 바이럴 예측(`/post/forecast`, MCP `forecast_posts`)을 게시 후 **1시간**부터 사용할 수 있으며(기존 2시간), 예측 모델도 업데이트되었습니다. 게시 후 1–2시간 된 게시물도 이제 과금됩니다.

## 2026-08-29 · 1.8.0

- **새 기능**: `GET /live/posts`, `GET /live/users`와 MCP `get_live_posts`, `get_live_users`. Threads에서 게시물과 계정의 **현재** 수치를 실시간으로 읽어 오며, 게시 시점이나 계정에 제한이 없습니다. 게시물 또는 계정 1개당 3크레딧이며, Threads가 조회수를 숨긴 경우 1크레딧입니다. 읽기에 실패하면 과금하지 않습니다.

## 2026-08-25 · 1.7.1

- **개선**: `/user/{username}/top-threads`에서 긴 기간을 조회할 때 속도가 크게 빨라졌습니다.
- **수정**: 빈 결과를 반환하면서 크레딧을 차감하는 문제가 더 이상 발생하지 않습니다. 백엔드를 일시적으로 사용할 수 없을 때는 503을 반환합니다.

## 2026-08-21 · 1.6.1 / 1.6.2

- **수정**: 인기 게시물, 게시물 답글 체인, 시맨틱 검색, 랭킹, 계정 게시물의 `post_timestamp`가 실제보다 8시간 이르게 표시되던 문제를 수정했습니다.
- **개선**: 바이럴 예측에서 쉼표로 구분한 여러 게시물 코드를 받을 수 있으며, 오류 메시지가 더 명확해졌습니다. 예측 가능 기간을 벗어난 게시물은 과금하지 않습니다.
- **수정**: Webhook 테스트 이벤트 엔드포인트가 500을 반환하던 문제를 수정했습니다.

## 2026-08-18 · 1.6.0

- **새 기능**: `GET /post/forecast`와 MCP `forecast_posts`(바이럴 예측). 게시물의 현재 조회수와 조회수 기준별 도달 확률, 예상 도달 시간을 반환합니다. 게시물당 10크레딧.

## 2026-07-29 · 1.5.0

- **새 기능**: 새 지역 값 `zh`, `tw`, `hk`, `cn`, `jp`, `kr`. 검색, 인기 게시물, 키워드 트렌드, 랭킹, Webhook에 적용됩니다. `tw`와 `cn`은 번체와 간체를 구분합니다. 기존 `chinese`, `japanese`, `korean`도 계속 사용할 수 있습니다. 자세한 내용은 [지역과 언어](/ko/api/guides/regions/)를 참고하세요.
- **개선**: 시맨틱 검색 REST API가 한 번에 최대 3000개 게시물을 반환할 수 있습니다. 좋아요 수와 답글 수 기준은 의미 매칭 이후에 적용됩니다.
- **개선(MCP)**: 모든 도구 설명에 가격이 표시됩니다. 사다리 계열 도구에서 지역을 지정할 수 있습니다.

## 2026-07-26 · 1.4.0

- **새 기능**: `GET /post/semantic-search`와 MCP `semantic_search_posts`(시맨틱 검색). 주제를 한 문장으로 설명하면 최근 30일 안에서 의미가 가장 가까운 게시물을 찾아 주며, 각 결과에 관련도 점수가 붙습니다. 처음 10개에 30크레딧, 이후 1개당 2크레딧. 자세한 내용은 [시맨틱 검색](/ko/api/semantic-search/)을 참고하세요.
- **새 기능**: Webhook 규칙에 조회수(`view_count`) 기준을 설정할 수 있습니다(07-23).
- **새 기능**: Webhook 규칙을 언어나 시장별로 필터링할 수 있습니다(07-15).
- **개선**: 인기 게시물, 게시물 답글 체인, 상세 정보 포함 검색, 계정 조회, 계정 인기 게시물이 조회수 `impression_count`를 반환합니다(07-13).
- **수정**: 인기 게시물을 조회수순으로 정렬하면서 홍콩이나 언어 필터를 함께 쓸 때 발생하던 문제를 수정했습니다(07-15).
- **개선(MCP)**: 도구 호출이 60초를 넘으면 멈춰 있지 않고 안내 메시지를 반환합니다(07-11).

## 2026-06-29

- **변경**: Webhook을 만들려면 API Standard 이상 요금제가 필요합니다.
- **변경**: Webhook 규칙에 최소 좋아요 수와 답글 수 기준이 적용됩니다.

## 2026-06-19 · 1.2.0

- **새 기능**: 검색, 인기 게시물, 키워드 트렌드에 `language` 매개변수(`chinese`, `hk`, `japanese`, `korean`)가 추가되었습니다.

## 2026-06-16 · 1.2.0

- **새 기능**: REST 랭킹·통계 엔드포인트. `/leaderboard/cool-replies`(명댓글), `/leaderboard/post-like-growth`(바이럴 게시물), `/leaderboard/follower-growth`(팔로워 증가), `/stats/follower-ladder`, `/stats/like-ladder`, `/stats/power-hours`, `/post/inspiration`(영감 검색).

## 2026-06-15 · 1.1.0

- **새 기능(MCP)**: `get_cool_replies`, `get_post_like_growth`, `get_follower_growth`, `get_follower_ladder`, `get_like_ladder`, `get_power_hours`, `get_inspiration` 도구가 추가되었습니다.

## 2026-06-10 · 1.0.0

- **새 기능(MCP)**: MCP 서버 `https://premium-api.throk.ai/mcp` 출시. REST API와 같은 키와 가격을 사용합니다. 첫 도구: `search_posts`, `get_hot_posts`, `get_keyword_trend`, `get_user`, `get_user_top_threads`, `get_user_follower_history`, `get_balance`. 설정 방법은 [AI 어시스턴트에서 사용하기(MCP)](/ko/api/mcp/)를 참고하세요.

## 2026-05-19

- **새 기능**: Webhook 「인기 임계값」 규칙. 키워드를 비워 둘 수 있으며, 조회 기간을 1–72시간으로 설정할 수 있습니다.