Google Trends
For a keyword (`q`), its related queries and topics; for a region with no keyword (`geo` alone), what is trending there now.
For a keyword (q), its related queries and topics; for a region with no keyword
(geo alone), what is trending there now. An Explore page that found nothing is a valid answer with empty
lists.
Under the document-form parameters (q with up to five keywords, data_type TIMESERIES,
GEO_MAP, RELATED_QUERIES or RELATED_TOPICS, geo, time, cat, gprop, tz, region)
the answer is the document with the block of the data_type (interest_over_time,
interest_by_region, related_queries, related_topics). $1 request $2 date, or with geo
alone, is the call above. What is trending now, in the document form, is
/v1/google/trends/trending-now.
X-API-Key<token>Your API key.
cancel_token?stringA name you make up for this request (a UUID is fine), so you can later GET /v1/cancel
with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.
1 <= length <= 128q?|The keyword. Sent: its related queries and topics. Left out: the region's trending searches.
geo?|ISO 3166-1 alpha-2, or a sub-region (US-CA). Required without q.
date?stringExplore's time range, e.g. today 12-m, now 7-d.
hl?stringLeave at en.
"en"data_type?stringAny case.
"TIMESERIES""TIMESERIES""GEO_MAP""RELATED_TOPICS""RELATED_QUERIES"time?stringnow 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all, or YYYY-MM-DD YYYY-MM-DD (YYYY-MM-DDTHH for hours).
"today 12-m"cat?stringGoogle's category id. Alone (no q) it is that category's interest.
"0"region?stringThe resolution of GEO_MAP; default CITY with a geo, else COUNTRY.
"COUNTRY""REGION""DMA""CITY"gprop?stringEmpty is web search.
"""""images""news""froogle""youtube"tz?integerMinutes from UTC.
-1439 <= value <= 1439420The keyword's related queries and topics, or the region's trending searches; with the document-form parameters, the document.
application/json- response
An Explore page that found nothing is a valid answer with empty lists.
search_metadata*search_parameters*The request's own fields as sent, engine first, without cancel_token.
search_information*The parser's own, e.g. yelp_search's; otherwise {}.
query?string|nullgeo?string|nulltrending_searches?array<>The "Related queries" widget.
related_topics?array<>The "Related topics" widget. Often empty.
total_results?integercurl -X GET 'https://api.justserp.com/v1/google/trends?q=pizza&geo=US&date=today+12-m'{ "search_metadata": { "id": "string", "status": "Success", "created_at": "string", "request_url": "string", "html_url": "string" }, "search_parameters": {}, "search_information": {}, "query": "string", "geo": "string", "trending_searches": [ { "position": 0, "query": "string", "value": "string", "is_breakout": true, "growth_percent": 0, "link": "string" } ], "related_topics": [ { "position": 0, "query": "string", "value": "string", "is_breakout": true, "growth_percent": 0, "link": "string" } ], "total_results": 0}Google Maps search GET
The places a Google Maps search lists, about 20, each completed from Google's own record of the place: ids, coordinates, categories, phone, website, the week's hours, attributes.
Google Trends Trending Now GET
What is trending on Google now for a country, region or metro, under the Google Trends Trending Now parameters (`geo`, `hl`, `time`) and answered as the document: `search_metadata`, `search_parameters` and `trends` (every trend of the window, 583 for the US over 24 hours, not the 25 rows the page draws: query, search volume, growth, categories, start and end, keywords).