Google SERP Trends Search#

Use this focused Just Serp API skill for Google SERP Trends Search. It targets GET /api/v1/google/trends/search. Required inputs are query. OpenAPI describes it as: Get Google trends Search data, including interest over time, geo breakdowns, and related queries, for demand analysis and seasonal trend monitoring.

Endpoint Scope#

• Group key: google
• Endpoint key: trends/search
• Group family: Google SERP
• Skill slug: justserpapi-google-trends-search

OperationVersionMethodPathOpenAPI summaryTrendsSearch``v1``GET``/api/v1/google/trends/searchSearch

Inputs#

ParameterInRequired byOptional byTypeNotescat``queryn/aallstringThe search category code (e.g., '0' for all categories)data_type``queryn/aallstringThe type of trend data to retrieve. Supported values: 'TIMESERIES' (Interest over time), 'GEO_MAP' (Breakdown by region)date``queryn/aallstringDate range filter for the search. Supports predefined values (now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all) and custom ranges: yyyy-mm-dd yyyy-mm-dd (e.g. 2021-10-15 2022-05-25) or hourly yyyy-mm-ddThh yyyy-mm-ddThh within 1 week (e.g. 2022-05-19T10 2022-05-24T22, based on tz)geo``queryn/aallstringThe geographic location code to filter trends (e.g., 'US', 'GB'). Omit for worldwide trends. See Google Trends Locationsgprop``queryn/aallstringThe Google property to filter trends. Supported values: 'images', 'news', 'froogle' (Shopping), 'youtube'language``queryn/aallstringSet the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Languagequery``queryalln/astringThe search term or topic ID to analyze in Google Trends (e.g., 'iPhone', '/m/027lnzs' for Bitcoin). You can provide up to 5 terms separated by commas for comparisonsregion``queryn/aallstringRefines results for region charts. Supported values: 'COUNTRY', 'REGION', 'DMA', 'CITY'tz``queryn/aallintegerTime zone offset in minutes (e.g., '420' for PDT). Range: -1439 to 1439

Request body: none documented; send parameters through path or query arguments.

Version Choice#

Use TrendsSearch for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint#

Supported operation IDs in this skill: TrendsSearch.

bash

node {baseDir}/bin/run.mjs --operation "TrendsSearch" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"<query>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, URLs, keywords, and filters unchanged.

Environment#

• Required: JUST_SERP_API_KEY
• Pass the API key with --api-key "$JUST_SERP_API_KEY"; do not paste key values into chat messages, screenshots, or logs.
• Project site: Just Serp API.
• Authentication details: Just Serp API Docs.

Output Focus#

• State the operation ID and endpoint path used, for example TrendsSearch on /api/v1/google/trends/search.
• Echo the required lookup scope ( query) before summarizing results.
• Prioritize fields that support this endpoint purpose: Get Google trends Search data, including interest over time, geo breakdowns, and related queries, for demand analysis and seasonal trend monitoring.
• Return raw JSON only after the short, endpoint-specific summary.
• If the backend errors, include the backend payload and the exact operation ID.