Keyword modes return a value on a 0-100 scale. 100 is the peak of that series in the returned window. Other points are relative to that peak. Every keyword source uses that scale, so a google search series and a tiktok series can be plotted or subtracted without a second unit conversion. Absolute counts, when the source has them, arrive in a separate volume field. That split is on volume vs score. The HTTP call is POST https://api.trendsapi.ai/api. Parse the string body before reading value.
What the index is
On get_time_series, each point has date and value. On get_growth, each window has recent_value and baseline_value, still 0-100, plus growth as a percent. news sentiment is still on that scale; it is tone, not mention count. Mention count is news volume.
POST https://api.trendsapi.ai/api
Authorization: Bearer <api_key>
Content-Type: application/json
{"mode":"get_time_series","source":"google search","keyword":"bitcoin"}
Do not treat value as searches per day. Do not sum value across keywords and call the total a market share. Each series is scaled to itself.
Why sources share one scale
A cross-platform question is two POSTs (or one get_growth with a comma-separated source list) and a compare. tiktok at 80 next to google search at 40 is a statement about relative position on each series, not about equal raw events. That is still enough to ask "did social move first." The source strings sit on the sources hub.
Live boards do not use this index. get_top_trends returns rank and a label. Rank 1 is first on that board, not a 100 score.
What the score is not
| Thing | Relationship to value |
|---|---|
Absolute volume |
Separate field, when present |
growth |
Percent change between two values |
| Google official alpha | Unscaled, application-gated, Google-only |
| Live feed rank | A board position, different mode |
Google documents the official alpha, including unscaled values, on Search Central. That API is not this endpoint.
Growth windows sit on top of the score
percent_growth presets such as 3M and 12M compare two 0-100 points. The preset list is on growth windows. Mode notes sit on the API reference. Plan names stay on pricing.