List Google Trends trending headlines
List the ten searches trending on Google Trends with their news.
Headers
Get your API keyAPI key (`sfk_...`)
Place: an ISO 3166-1 country code (`US`, `DE`) or a subdivision code (`US-CA`, `DE-BY`). Lowercase input is accepted and normalised to uppercase. Default: `US`.
pattern: ^[A-Z]{2}(?:-[A-Z0-9]{1,3}){0,2}$
Endpoint-specific response payload.
`found` when Google Trends answered; the list is fixed at ten items, so an empty list is still `found` with no trends.
one of: found
The geo of this result.
The list is fixed at ten items; there is no parameter for more.
one of: 10
Up to ten trending queries with their news items.
The trending query, in the local language.
Search volume bucket. It is a bucket, not a count.
The bucket as Google Trends writes it, e.g. `100+` or `2000+`.
The bucket's lower bound, e.g. 2000 for `2000+`; null if unreadable.
When the trend started, ISO 8601 UTC.
The trend's picture; null when none was sent.
Thumbnail URL.
Publisher the thumbnail belongs to.
Up to three news items for this trend.
Headline.
Publisher URL.
Publisher name.
Headline thumbnail; null when it repeats the trend's picture.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/google-trends/trending/headlines?geo=US" \
-H "x-api-key: YOUR_API_KEY"Responses
Google Trends trending headlines.