A Vala job talks to Trends API with one POST to https://api.trendsapi.ai/api, a Bearer key, and a JSON body that names a mode. There is no official Vala library. Soup.Session ships in libsoup 3.0. Json.Parser ships in json-glib. The first parse reads the envelope, then a second parse reads the body string. Pulled on 2026-11-08, Google Search for vala programming scored 6.0 for the week of 2026-11-07, down 50.0% from 12.0. vala language scored 27.0, down 22.86% from 35.0. Those two tokens closed 21 points apart, with the language phrase above the programming phrase. YouTube for vala programming scored 0.0 versus 0.0. Do not copy bare vala Search 87.0 onto a language-adoption alert that only watches the phrase token at 6.0. The same helper that stores those rows also pulls a live Google Trends board. A rank-2 name whose weekly Search still printed 10.0 while daily Search printed 100 is documented in James Talarico live rank versus weekly Search.
How does a Vala client call Trends API?
POST https://api.trendsapi.ai/api
Authorization: Bearer <api_key>
Content-Type: application/json
{"mode":"get_growth","source":"google search","keyword":"vala programming","percent_growth":["7D","30D","3M","12M"]}
void main () {
var key = Environment.get_variable ("TRENDSAPI_API_KEY");
var session = new Soup.Session ();
var message = new Soup.Message ("POST", "https://api.trendsapi.ai/api");
message.get_request_headers ().append ("Authorization", "Bearer " + key);
string payload = """{"mode":"get_growth","source":"google search","keyword":"vala programming","percent_growth":["7D","30D","3M","12M"]}""";
message.set_request_body ("application/json",
new MemoryInputStream.from_data (payload.data), payload.length);
try {
var response = session.send_and_read (message);
var parser = new Json.Parser ();
parser.load_from_data ((string) response.get_data (), -1);
var envelope = parser.get_root ().get_object ();
var inner = new Json.Parser ();
inner.load_from_data (envelope.get_string_member ("body"), -1);
stdout.printf ("%s\n", Json.to_string (inner.get_root (), false));
} catch (Error e) {
stderr.printf ("%s\n", e.message);
}
}
new Soup.Session owns the HTTP client. new Soup.Message takes the method and URL. get_request_headers ().append sets the Bearer key. set_request_body holds the JSON bytes. send_and_read sends POST and returns the transport bytes. Json.Parser.load_from_data on those bytes, then a second Json.Parser on the body string. Compile the sample with:
valac --pkg libsoup-3.0 --pkg json-glib-1.0 trends.vala
https://valadoc.org/libsoup-3.0/Soup.Session.html
https://valadoc.org/libsoup-3.0/Soup.Message.html
https://valadoc.org/json-glib-1.0/Json.Parser.html
https://docs.vala.dev
Soup.Session and Json.Parser are client libraries. They are not Trends API sources. There is no vala add or registry install step for this sample.
The response envelope is {"statusCode": int, "body": string}. body is a JSON string and must be parsed a second time before reading recent_value. A Haxe client that does the same double parse with haxe.Http is on Haxe Trends API. A Gleam client is on Gleam Trends API.
What did get_growth return for Vala language tokens?
get_growth for vala programming on google search tips on 2026-11-07. Store the exact strings. vala language is a different series. The language phrase closed 21 points above the programming phrase on the same week.
| Keyword | Period | Recent date | Recent | Baseline date | Baseline | Growth |
|---|---|---|---|---|---|---|
| vala programming | 7D | 2026-11-07 | 6.0 | 2026-10-31 | 12.0 | -50.0% |
| vala programming | 14D | 2026-11-07 | 6.0 | 2026-10-24 | 0.0 | vs 0.0 |
| vala programming | 30D | 2026-11-07 | 6.0 | 2026-10-10 | 0.0 | vs 0.0 |
| vala programming | 3M | 2026-11-07 | 6.0 | 2026-08-08 | 0.0 | vs 0.0 |
| vala programming | 12M | 2026-11-07 | 6.0 | 2025-11-08 | 0.0 | vs 0.0 |
| vala programming | YTD | 2026-11-07 | 6.0 | 2026-01-03 | 0.0 | vs 0.0 |
| vala language | 7D | 2026-11-07 | 27.0 | 2026-10-31 | 35.0 | -22.86% |
| vala language | 14D | 2026-11-07 | 27.0 | 2026-10-24 | 56.0 | -51.79% |
| vala language | 30D | 2026-11-07 | 27.0 | 2026-10-10 | 41.0 | -34.15% |
| vala language | 3M | 2026-11-07 | 27.0 | 2026-08-08 | 63.0 | -57.14% |
| vala language | 12M | 2026-11-07 | 27.0 | 2025-11-08 | 0.0 | vs 0.0 |
| vala language | YTD | 2026-11-07 | 27.0 | 2026-01-03 | 54.0 | -50.0% |
| valac | 7D | 2026-11-07 | 38.0 | 2026-10-31 | 42.0 | -9.52% |
| valac | 12M | 2026-11-07 | 38.0 | 2025-11-08 | 28.0 | +35.71% |
| valac | YTD | 2026-11-07 | 38.0 | 2026-01-03 | 40.0 | -5.0% |
| vala | 7D | 2026-11-07 | 87.0 | 2026-10-31 | 100.0 | -13.0% |
| vala | 12M | 2026-11-07 | 87.0 | 2025-11-08 | 56.0 | +55.36% |
| vala | YTD | 2026-11-07 | 87.0 | 2026-01-03 | 74.0 | +17.57% |
get_time_series for vala programming on Google Search closed at 6.0 on 2026-11-07, matching get_growth 6.0. Adjacent weeks: 12.0 on 2026-10-31, 0.0 on 2026-10-24, 0.0 on 2026-10-17, 0.0 on 2026-10-10. Peak in this pull is 100.0 on 2023-12-30. Next highest points are 91.0 on 2026-02-07, 83.0 on 2025-06-14, and 76.0 on 2026-02-28. Tip 6.0 is not that December 2023 high. The payload marked data_quality low with a warning that the underlying signal is over 90% zeros. The payload printed growth 999999 on 14D, 30D, 3M, 12M, and YTD because those baselines were 0.0. Report 6.0 versus 0.0. 7D printed -50.0% versus 12.0, the same sign as vala language 7D -22.86% versus 35.0, at a 21-point lower close.
vala language closed at 27.0, down 22.86% from 35.0. Same 7D sign as vala programming, 21 points above that close. 12M baselined at 0.0. Report 27.0 versus 0.0. Do not copy programming 6.0 onto language 27.0.
valac closed at 38.0, down 9.52% from 42.0, 32 points above programming 6.0. 12M was 38.0 versus 28.0 (+35.71%). YTD was 38.0 versus 40.0 (-5.0%). That compiler token is not package-download volume. There is no Vala package-registry source on this API.
Bare vala closed at 87.0, down 13.0% from 100.0. 14D was 87.0 versus 93.0 (-6.45%). 30D was 87.0 versus 95.0 (-8.42%). 3M was 87.0 versus 91.0 (-4.4%). 12M was 87.0 versus 56.0 (+55.36%). YTD was 87.0 versus 74.0 (+17.57%). That four-character string mixes other uses of the word. Do not treat Search 87.0 as Vala language adoption.
Neighbor languages on the same pull, same source, same 7D window, same 2026-11-07 tip:
| Keyword | 7D recent | 7D baseline | 7D growth | 12M recent | 12M baseline | 12M growth |
|---|---|---|---|---|---|---|
| vala programming | 6.0 | 12.0 | -50.0% | 6.0 | 0.0 | vs 0.0 |
| vala language | 27.0 | 35.0 | -22.86% | 27.0 | 0.0 | vs 0.0 |
| rust programming | 22.0 | 19.0 | +15.79% | 22.0 | 31.0 | -29.03% |
| zig programming | 15.0 | 17.0 | -11.76% | 15.0 | 35.0 | -57.14% |
| odin programming | 15.0 | 14.0 | +7.14% | 15.0 | 29.0 | -48.28% |
| nim programming | 14.0 | 15.0 | -6.67% | 14.0 | 31.0 | -54.84% |
| vlang | 13.0 | 18.0 | -27.78% | 13.0 | 23.0 | -43.48% |
| jai programming | 12.0 | 9.0 | +33.33% | 12.0 | 0.0 | vs 0.0 |
| gleam programming | 11.0 | 9.0 | +22.22% | 11.0 | 0.0 | vs 0.0 |
| c3 programming | 11.0 | 9.0 | +22.22% | 11.0 | 21.0 | -47.62% |
| haxe programming | 8.0 | 11.0 | -27.27% | |||
| hare programming | 8.0 | 7.0 | +14.29% | 8.0 | 0.0 | vs 0.0 |
| crystal programming | 4.0 | 3.0 | +33.33% | 4.0 | 22.0 | -81.82% |
vala programming 6.0 sat 16 points below rust programming 22.0 and 9 points below zig programming 15.0. It sat 2 points below haxe programming 8.0 and 5 points below gleam programming 11.0. vala language 27.0 sat 5 points above rust. Do not copy rust 22.0 onto vala programming 6.0. Do not copy language 27.0 onto programming 6.0. High-volume php in this session still tipped on 2026-10-24 at 100.0 versus 22.0 with estimated volume 2,200,000. That is a different Saturday tip. Store the session pull and the exact recent_date per keyword. A Zig Trends API helper stores the systems-language neighbor on the same 7D window. A Hare Trends API helper stores hare programming.
What did YouTube, News, and Wikipedia return?
YouTube for vala programming printed zeros on every growth window. Keyword Google News for both Vala phrases printed zeros. Wikipedia titles resolve on their own. Compare Wikipedia on volume.
YouTube for vala programming tipped 0.0 on 2026-11-07 versus 0.0, while Search sat at 6.0. The payload marked data_quality low. Store the zeros. YouTube 0.0 is not Search 6.0. Do not treat the YouTube floor as language adoption while Search sits at 6.0 after a 100.0 close in December 2023.
YouTube for vala language closed at 21.0, down 34.38% from 32.0, also data_quality low. 12M was 21.0 versus 0.0. Report 21.0 versus 0.0. Language YouTube 21.0 is not programming YouTube 0.0. Do not copy language YouTube 21.0 onto programming Search 6.0.
Bare vala YouTube closed at 78.0, down 1.27% from 79.0. 12M was 78.0 versus 69.0 (+13.04%). That is not the phrase series. Do not copy bare YouTube 78.0 onto programming YouTube 0.0.
Keyword Google News for vala programming printed 0.0 versus 0.0 on every window, also data_quality low. Store the zeros. Keyword Google News for vala language printed 0.0 versus 0.0 on 7D and 12M, also data_quality low. Do not fill News from Search 6.0. Keyword News and the Google News Top News board are different feeds. Mode docs sit at https://trendsapi.ai/docs.
Wikipedia for parenthetical title Vala (programming language) resolved. October 2026 scored 5.8 with 1,938 pageviews versus September 3.5 with 1,875 (volume +3.36%). 3M score printed versus 0.0 (growth 999999) while volume was 1,938 versus July 1,781 (+8.82%). Report the volume. 12M was 5.8 / 1,938 versus October 2025 37.5 / 2,789 (volume -30.51%). YTD was 5.8 / 1,938 versus December 2025 56.9 / 3,308 (volume -41.41%). 7D and 14D collapsed (collapsed_range: recent and baseline resolved to the same monthly point). Peak in this pull is 100.0 / 4,467 in July 2022. Short title Vala resolved to a different page. October scored 0.0 with 153 pageviews versus September 2.2 with 168 (volume -8.93%). Do not join 1,938 views onto Search 6.0. Do not treat short-title Vala at 153 views as the language page. The language title is the finding. That is the opposite of Haxe, where the short title was the high-volume page. Wikipedia source docs sit at https://trendsapi.ai/trends/wikipedia-trends.
There is no Vala package-registry source on this API. npm covers npmjs. python covers PyPI. A Vala watchlist that wants package downloads has no third source to join onto Search 6.0.
How does a watchlist store live boards next to weekly scores?
get_top_trends has no keyword. Pair the live Google Trends board with get_growth on the exact board string. Live rank, 1-day rank_change, and 7-day rank_change are three feeds. The rank snapshot can stamp at the same second as the mover snapshot, or days earlier than Wikipedia Trending.
POST https://api.trendsapi.ai/api
Authorization: Bearer <api_key>
Content-Type: application/json
{"mode":"get_top_trends","type":"Google Trends","limit":25}
On 2026-11-04T07:01:36Z the live Google Trends board ranked james talarico at 2. Wikipedia Trending, YouTube Trending, and Google News Top News stamped 2026-11-08T09:01:38Z, four days later. Weekly Search for james talarico scored 10.0 versus 10.0 on the 2026-10-31 tip. Daily Search printed 100 on 2026-11-04. YouTube scored 83.0 versus 17.0 on the 2026-11-07 tip. The helper that stores those rows is the blog in this batch: James Talarico live rank versus weekly Search. Do not copy that daily 100 onto vala programming 6.0. Board-shape notes for Google Trends live feeds sit at https://trendsapi.ai/trends/google-trends.
Free tier is 100 successful 200s per month. Only 200 responses count against quota. Five language tokens plus one live board is 6 calls. A Monday run that also pulls YouTube and Wikipedia for the programming phrase is 8 calls. Four weeks is 32 calls and still fits the free cap. Starter is 5,000, Pro 25,000, Business 100,000.
Envelope checklist
POSThttps://api.trendsapi.ai/apiwithAuthorization: Bearer <api_key>.- Parse the transport JSON, then parse the
bodystring a second time. - Store
vala,vala programming,vala language, andvalacas separate series. - Compare Wikipedia
Vala (programming language)on volume at 1,938 October views, not short-titleValaat 153. - Pair
get_top_trendsrank with bothrank_changewindows andget_growthon the exact board string. Store each keyword'srecent_date.