Google Trends API reference
Get Google Trends data as JSON: how interest in a search term changes over time, where it is searched most, and what is trending in a country right now. No browser and no scraping code.
The Google Trends API has 5 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Google Trends in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The input most of them take is country. Every endpoint costs 2 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
google_trends.interest.over_time |
Compare interest in one or two search terms or topics over the past 12 months or 5 years, worldwide or in one country, as Google's 0 to 100 scores. | 2 credits |
google_trends.trending.list |
List what is trending on Google in a country over the last 4, 24 or 48 hours or 7 days: each search with its volume, growth, start time, categories and related queries. | 2 credits |
google_trends.interest.by_region |
See where a search term or topic is searched most, region by region, scored 0 to 100. | 2 credits |
google_trends.topics.autocomplete |
Find Google topic IDs for a word, such as Coffee the beverage, to compare a topic rather than one exact spelling. | 2 credits |
google_trends.trending.daily |
Get Google's daily trending searches for a country or a state, with each search's traffic band, start time and the news behind it. | 2 credits |
What to know
- Scores, not search counts Interest over time and by region are Google's 0 to 100 scores: 100 is the peak in the window you asked for. Compare terms in one call to keep them on the same scale.
- No data is not zero When Google has too little data for a week or a region, the response says so instead of reporting zero.
- Trending volumes are rounded Trending searches carry the rounded volume Google shows, such as 5,000,000+, and growth against the expected level.
- Topics or exact words A word matches that spelling only. A topic ID from the topics endpoint covers every way people search for the same thing.
Something missing or unclear? Ask the team that builds the Google Trends endpoints.