Google Trends API
- Data from Google Trends
Google Trends API for interest over time and related queries
Chart how search interest in a keyword moves over time in any country, and see the top and rising searches around it. The numbers Google Trends shows, as JSON.
1,000 free credits a month · Failed requests are free · Free during the beta
Endpoints and prices checked against the API on
Google Trends is the public record of what people search for, which makes it a standard input for demand forecasting, seasonality, content planning and spotting rising topics early. Google’s official Trends API is an alpha for approved testers, so most teams read the public site. This API returns the data behind its charts: a keyword’s interest over time and the top and rising searches related to it.
Trends values are not search counts. Each timeline is scaled from 0 to 100 against the keyword’s own peak in the chosen window and country, and the API returns those values unchanged. Rising queries are growth percentages; above 5000% Google shows “Breakout”, carried as breakout: true. When Google treats a request as automated it mixes decoy entries into related queries, so the API checks for that signal and retries from another network instead of returning them. A call that cannot get a clean answer fails and is not charged.
What you get
series[].points[]— the timeline: one point per period Google reports for the windowdate, value— each point’s date and its interest from 0 to 100, relative to the keyword’s peaktop[]— the most searched related queries, scored 0 to 100 against the top onerising[]— the related queries growing fastest, with growth as a percentagebreakout— true when Google labels growth “Breakout” (above 5000%); value is then emptyquery, kind— the related search text and whether it is a top or rising entrysearch_parameters— the keyword, country and time range the answer is for
One call, structured JSON
POST /v1/trends/interest — 2 credits per successful call.
curl -X POST "https://api.scrapercompany.com/v1/trends/interest" \
-H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "Hilton"
}'{
"search_parameters": {
"engine": "google_trends_interest",
"keyword": "Hilton",
"geo": "US",
"time_range": "today 1-m"
},
"series": [
{
"points": [
{
"date": "2029-02-05",
"value": 41
},
{
"date": "2029-02-06",
"value": 38
}
]
}
],
"total": 4,
"meta": {
"source": "google_trends",
"wire_bytes": 8456,
"elapsed_s": 0.612
}
}Endpoints and price per call
Credits per successful call, and what one call costs on the Starter, Growth, Scale plans. Failed requests cost nothing. See all plans.
| Endpoint | What it returns | Credits | Starter · Growth · Scale |
|---|---|---|---|
| Interest over time POST /v1/trends/interest | The 0–100 timeline for one keyword, country and time range | 2 credits | $0.0020 · $0.0012 · $0.0008 |
| Related queries POST /v1/trends/related | Top and rising searches related to a keyword, with Breakout flagged | 2 credits | $0.0020 · $0.0012 · $0.0008 |
FAQ
Frequently asked questions
Read next
Is there an official Google Trends API?
Google has announced an official Google Trends API, offered as an alpha to a limited group of developers it accepts through an application on Google Search Central. It is not an open, self-serve API. This API is independent of Google and returns the data shown on the public Google Trends site.
Are Google Trends numbers search volumes?
No. Google scales each timeline from 0 to 100, where 100 is the busiest point for that keyword in the chosen window and country. The API returns those values unchanged, so a value of 50 means half the peak interest, not a number of searches.
Which time ranges and places can I ask for?
time_range uses Google’s own syntax: today 1-m (the default), now 7-d, today 12-m, all, or a start and end date such as 2026-01-01 2026-06-30. geo is a two-letter country code, US by default, and hl sets the language. Regions within a country are not supported.
What does Breakout mean in rising queries?
Rising queries show how much a related search grew compared with the previous period, as a percentage. When the growth is above 5000%, Google shows “Breakout” instead of a number, and the API returns breakout: true with an empty value.
Can I compare several keywords in one call?
No. Each call takes one keyword, and its values are scaled to that keyword’s own peak, so results from separate calls are not on a common scale. Compare the shape and timing of the curves rather than their absolute levels.
Do failed requests cost credits?
No. A failed or blocked call (any 4xx or 5xx response) costs 0 credits, and so does a search page that comes back empty. You pay only for successful results.
How do I get an API key?
Create an account on the sign-up page. Public sign-up is invite-only during the beta, so join the waitlist there and we will email you when your account is ready. The Free plan includes 1,000 credits a month, and the API is free while it is in beta. You create and rotate keys yourself in the dashboard.
More APIs on the same key
All APIsBooking.com API
Look a hotel up by name, then read what Booking.com shows a guest: a nightly price calendar, each room type with its rate plans, and the reviews with the property’s replies. Structured JSON, priced per call.
Expedia API
Look a hotel up by name, then read what Expedia shows a guest for one stay: every room type and rate plan with its total, nightly price and cancellation terms, and the guest reviews with the property’s replies.
Hotels.com API
Find a hotel’s Hotels.com id by name, then read what a guest on the Hotels.com site for their country sees: the headline price for a stay, every room type and rate plan, and the guest reviews.
Agoda API
Look a hotel up by name, then read every room type and rate plan Agoda shows a guest for one stay, with the stay total, discounts, meal plan and cancellation terms, in any of 23 currencies.
Start with 1,000 free credits a month
Join the waitlist and we will email you when your account is ready: your own API keys, 1,000 free credits a month, and the API is free during the beta.