Throk API·MCP 업데이트 내역

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

2026-10-28 · 1.20.2

• Webhook: 키워드 규칙의 조회수(view_count) 임계값 최솟값이 5,000에서 1,000으로 낮아졌습니다. 인기 임계값 규칙은 5,000을 유지합니다. 자세한 내용은 Webhook을 참고하세요.

2026-10-26 · 1.20.1

• Webhook: 조회수(view_count) 임계값의 최솟값이 20,000에서 5,000으로 낮아졌습니다. 키워드 규칙과 인기 임계값 규칙 모두에 적용됩니다. 자세한 내용은 Webhook을 참고하세요.

2026-10-09 · 1.20.0

• 새 기능: /post/inspiration과 MCP get_inspiration에 language를 지정할 수 있습니다. zh(중국어 전체: zh-Hant, zh-Hans, yue), zh-Hant(중국어 번체), zh-Hans(중국어 간체), yue(광둥어), en(영어), ja(일본어), ko(한국어). 지정하지 않으면 이전과 같이 중국어, 일본어, 한국어 게시물에서 가져오며 영어는 포함되지 않습니다. 요금은 변함없습니다(호출당 30크레딧, 최대 10건). 자세한 내용은 게시물 언어를 참고하세요.
• 새 기능: 영감 검색 대상에 영어 게시물이 추가되었습니다. 좋아요 1,000개 이상, 300자 이상인 원글이 대상입니다(중국어, 일본어, 한국어는 여전히 좋아요 1,000개 이상, CJK 문자 200자 초과). 영어 게시물은 2026-10-09부터 수집되며, 이전 영어 게시물은 순차적으로 보충하고 있습니다.

2026-10-09 · 1.19.0

• 새 기능: 시맨틱 검색이 영어 게시물을 지원합니다. /post/semantic-search와 MCP semantic_search_posts에 language=en을 지정할 수 있으며, 사용법과 요금은 다른 언어와 같습니다. 영어 게시물의 시맨틱 데이터는 이번 업데이트부터 쌓이기 시작하므로, 처음 몇 주 동안은 검색할 수 있는 기간이 30일보다 짧습니다. /post/inspiration(get_inspiration)에는 여전히 영어 게시물이 포함되지 않습니다.

2026-10-09 · 1.18.0

• 변경: 게시물을 필터링하는 모든 엔드포인트와 MCP 도구가 하나의 매개변수 language를 사용합니다. 값은 ISO 언어 코드(대소문자 구분 없음)로 zh(모든 중국어, 기본값), zh-Hant(중국어(번체)), zh-Hans(중국어(간체)), yue(광둥어), en(영어), ja(일본어), ko(한국어)입니다. 랭킹, 사다리, 황금 시간대도 language를 사용하며 언어별로 따로 계산합니다. ‘모든 언어’ 옵션은 없으며 호출 한 번에 한 언어를 조회합니다. 자세한 내용은 게시물 언어를 참고하세요.
• 새 기능: 영어 게시물(language=en)을 키워드 검색, 키워드 트렌드, 인기 게시물, 랭킹, 사다리, 황금 시간대에서 조회할 수 있습니다. 영어 게시물에서는 단수·복수 같은 어형 변화도 함께 매칭합니다. 자세한 내용은 검색 규칙을 참고하세요. 시맨틱 검색은 아직 영어를 지원하지 않습니다(400 반환).
• 새 기능: /leaderboard/follower-growth와 MCP get_follower_growth에 language를 지정할 수 있습니다(7개 모두 지원).
• Webhook: 규칙의 language에는 zh(기본값), zh-Hant, zh-Hans, yue, ja, ko를 지정할 수 있으며, 응답에도 항상 이 코드가 사용됩니다.

2026-10-02 · 1.17.0

• 새 기능: 개발자 플랫폼에서 API 키의 이름을 변경하고 교체(같은 이름으로 새 키를 발급하고 기존 키는 즉시 무효화)할 수 있으며, 마지막 사용 시점도 표시됩니다. 계정당 유효한 키는 최대 20개입니다.
• 개선: /post/inspiration과 MCP get_inspiration은 매일 업데이트되는 인기 게시물(좋아요 1,000개 이상)에서 찾습니다. 일본어·한국어 게시물이 포함될 수 있습니다.

2026-09-30 · 1.11.2

• 변경: /user/{username}/interactions와 MCP get_user_interactions의 기본 반환 수를 10개 계정으로 바꾸고(이전 20개), 계정 10개까지 30크레딧, 1개 추가될 때마다 2크레딧으로 조정했습니다(이전: 30개까지 70크레딧). 교류가 없으면 계속 무료입니다. MCP도 REST와 같이 한 번에 최대 100개 계정입니다.

2026-09-30 · 1.11.0

• 새 기능: GET /user/{username}/interactions와 MCP get_user_interactions(교류 랭킹). 최근 7–90일 동안 계정이 가장 자주 댓글을 주고받은 상대를 양쪽의 댓글 수와 마지막 교류 시각과 함께 반환합니다. 양방향 교류, 합계, 보낸 댓글, 받은 댓글 기준으로 정렬할 수 있습니다. 계정 30개에 70크레딧, 1개 추가될 때마다 2크레딧 추가, 교류가 없으면 무료입니다. 자세한 내용은 교류 랭킹을 참고하세요.

2026-09-25 · 1.10.0

• 새 기능: MCP에 Throk 계정으로 로그인(OAuth)해 연결할 수 있습니다. Claude, ChatGPT, Codex, Cursor를 지원하며, API 키가 필요 없고 계정의 API 크레딧을 그대로 사용합니다. 설정 방법은 AI 어시스턴트에서 사용하기(MCP)를 참고하세요.
• 변경: 크레딧 사용 기록의 「키」 열이 「출처」로 바뀌었고, Throk 계정으로 로그인한 AI 도구는 「계정 로그인 · 앱 이름」으로 표시됩니다.

2026-09-24 · 1.9.2

• 변경: /post/search에서 기간을 지정하지 않으면 최근 7일을 검색합니다(기존 3시간). 어떤 기간 조건이든 최대 90일 전까지만 조회합니다.
• 변경: 크레딧이 부족하면 HTTP 402를 반환합니다(기존 400).
• 변경: 매개변수 오류(서로 맞지 않는 기간 조건 포함)는 항상 HTTP 400, 형식은 {"detail": "오류 메시지"}입니다(기존에는 일부가 422).
• 변경: /post/forecast는 한 번에 최대 20개 게시물까지입니다.
• 개선: 키워드 트렌드가 tw와 cn을 지원합니다.
• 개선: post_type=thread를 include_details 없이 사용할 수 있습니다.
• Webhook: 이벤트에 rule 필드가 추가됩니다. 엔드포인트를 만들면 바로 테스트할 수 있습니다. 키워드 규칙에는 lookbackHours를 지정할 수 없습니다. 규칙의 language는 보낸 표기 그대로 반환되며, 필드 이름은 스네이크 케이스(예: like_count)도 받습니다.

2026-09-23 · 1.9.1

• 개선: Webhook 이벤트의 X-Throk-Signature 헤더에 v1 서명이 포함되어, Throk에서 보낸 이벤트인지 검증할 수 있습니다.

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에서 긴 기간을 조회할 때 속도가 크게 빨라졌습니다.
• 변경: 백엔드를 일시적으로 사용할 수 없을 때는 HTTP 503을 반환합니다. 잠시 후 다시 시도하세요.

2026-08-21 · 1.6.1 / 1.6.2

• 변경: 인기 게시물, 게시물 댓글 체인, 시맨틱 검색, 랭킹, 계정 게시물의 post_timestamp를 UTC 기준 Unix 시간(초)으로 통일해 다른 엔드포인트와 맞췄습니다.
• 개선: 바이럴 예측에서 쉼표로 구분한 여러 게시물 코드를 받을 수 있으며, 오류 메시지가 더 명확해졌습니다. 예측 가능 기간을 벗어난 게시물은 과금하지 않습니다.

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의 language 매개변수와 랭킹의 location 매개변수에 적용됩니다. tw와 cn은 번체와 간체를 구분합니다. 기존 chinese, japanese, korean도 계속 사용할 수 있습니다. 자세한 내용은 지역과 언어를 참고하세요.
• 개선: 시맨틱 검색 REST API가 한 번에 최대 3000개 게시물을 반환할 수 있습니다. 좋아요 수와 댓글 수 기준은 의미 매칭 이후에 적용됩니다.
• 개선(MCP): 모든 도구 설명에 가격이 표시됩니다. 사다리 계열 도구에서 지역을 지정할 수 있습니다.

2026-07-26 · 1.4.0

• 새 기능: GET /post/semantic-search와 MCP semantic_search_posts(시맨틱 검색). 주제를 한 문장으로 설명하면 최근 30일 안에서 의미가 가장 가까운 게시물을 찾아 주며, 각 결과에 관련도 점수가 붙습니다. 처음 10개에 30크레딧, 이후 1개당 2크레딧. 자세한 내용은 시맨틱 검색을 참고하세요.
• 새 기능: Webhook 규칙에 조회수(view_count) 기준을 설정할 수 있습니다(07-23).
• 새 기능: Webhook 규칙을 언어나 시장별로 필터링할 수 있습니다(07-15).
• 개선: 인기 게시물, 게시물 댓글 체인, 상세 정보 포함 검색, 계정 조회, 계정 인기 게시물이 조회수 impression_count를 반환합니다(07-13).
• 개선(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)를 참고하세요.

2026-05-19

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