Google Trends API
Retrieve Google Trends data for one to five comma-separated terms. time_range accepts all, now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, or an ordered YYYY-MM-DD date pair from 2004 through today.
Make a request
Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.
curl 'https://api.prismcrawl.com/v1/google/trends' \
--request POST \
--header 'content-type: application/json' \
--header 'x-api-key: <PRISMCRAWL_API_KEY>' \
--data '{
"query": "tesla"
}'Supported parameters
| Parameter | Usage |
|---|---|
queryRequired | Text to search for on the selected service. |
country | Two-letter country or storefront code, such as us or gb. |
language | Provider-supported language code, such as en. |
category | A category identifier supported by this operation. interest_over_time, interest_by_region, related_queries, related_topics |
time_range | Provider-supported time filter. |
device | Device presentation for the source request. desktop, mobile, tablet |
html | Return the encoded original response rather than parsed JSON. |
zero_trace | Do not archive source or parsed response artifacts. |
Structured results
Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.
timeformattedTimeformattedAxisTimevalueformattedValuehasDatageoCodegeoNamequeryrankedKeywordtyperankidtitlenameurlpositionthumbnailratingsnippetdescriptionaddresscategoryphonewebsitereview_countrating_maxrating_sourcelatitudelongitudecoordinatesSDKs and guides
The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.
- Python SDK:
pip install prismcrawl - Node.js SDK:
npm install prismcrawl