Social Fetch
Start for freeStart free
Google Trends hub

Google Trends Headlines API

The fixed ten-item trending list for a place, with volume, time, a picture and the stories behind each trend.

GET /v1/google-trends/trending/headlines

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/google-trends/trending/headlines returns the headline list for a place. The only parameter is geo, a country or subdivision code such as US, GB or DE-BY. The list is fixed at ten items, so data.limit is always 10 and there is no paging parameter.

On found, each item in data.trends[] has query, searchVolume.label and searchVolume.min (for example 2000+ and 2000), startedAt in ISO 8601 UTC, an image with url and source, and news[] with up to three items, each with title, url, source and an optional image. An empty list is still found with no rows. A geo Google Trends does not serve is a 400 with an input message, not a not-found.

Google Trends Headlines API FAQ

Why only ten items?

The list carries ten. There is no parameter for more, so data.limit is always 10. Use GET /v1/google-trends/trending when you need a longer list with a cursor.

What is in each news item?

news[] holds up to three records with title, url and source. image is the story thumbnail, or null when it repeats the trend's own picture.

What does an empty list mean?

The answer is lookupStatus found with an empty trends array. A quiet place can have no headlines, which is different from a geo Google Trends refuses.

What happens with an unsupported geo?

The route answers 400 and the request is not billed. GET /v1/google-trends/trending also refuses a place it does not serve with a 400.

How much does a headline lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Google Trends endpoints