get_growth answers a percent question. Send mode get_growth, a source, and a keyword. percent_growth is an array of preset strings. Omit it and the default is ["12M"]. The HTTP call is POST https://api.trendsapi.ai/api with Authorization: Bearer <api_key>. The envelope is {"statusCode": int, "body": string}. Parse body before reading results. Preset strings sit on growth period presets. The full field list sits on the API reference.
The request
POST https://api.trendsapi.ai/api
Authorization: Bearer <api_key>
Content-Type: application/json
{"mode":"get_growth","source":"google search","keyword":"bitcoin","percent_growth":["3M","12M"]}
source is one MCP value, or a comma-separated list. Valid names include google search, tiktok, youtube, amazon, npm, and app downloads. Copy the string. google without search is a 400.
A live pull on 27 Aug 2026 for bitcoin on google search returned two rows in one body: 3M growth 2.94 (35.0 vs 34.0) and 12M growth -41.67 (35.0 vs 60.0). calculation_method was point_to_point. metadata.total_data_points was 261.
What one result row is
| Field | Meaning |
|---|---|
period |
The preset, such as 12M |
growth |
Signed percent |
direction |
increase, decrease, or flat |
recent_value / baseline_value |
0-100 at those two dates |
recent_date / baseline_date |
The two dates |
growth is not the score. The score is recent_value. Absolute counts, when the source has them, arrive as volume fields on the same row. That split is on volume versus score.
A multi-source call changes the outer object. source_results holds one block per source. volume_weighted_growth is documented on volume-weighted growth.
When this mode is the wrong call
Need every weekly point for a chart? Use get_time_series. Need a live board with no keyword? Use get_top_trends. Need a launch-day pair that is not a preset? REST accepts {name, recent, baseline} objects. The MCP tool in this session lists presets only.
Plan caps stay on pricing.