Google SERP Trends Search API

Data & APIs

Call GET /api/v1/google/trends/search for Google SERP Trends Search through Just Serp API with query.

Install

openclaw skills install justserpapi-google-trends-search

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 summary
TrendsSearchv1GET/api/v1/google/trends/searchSearch

Inputs

ParameterInRequired byOptional byTypeNotes
catqueryn/aallstringThe search category code (e.g., '0' for all categories)
data_typequeryn/aallstringThe type of trend data to retrieve. Supported values: 'TIMESERIES' (Interest over time), 'GEO_MAP' (Breakdown by region)
datequeryn/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)
geoqueryn/aallstringThe geographic location code to filter trends (e.g., 'US', 'GB'). Omit for worldwide trends. See <a href="/reference/google-trends-locations">Google Trends Locations</a>
gpropqueryn/aallstringThe Google property to filter trends. Supported values: 'images', 'news', 'froogle' (Shopping), 'youtube'
languagequeryn/aallstringSet the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See <a href="/reference/google-language">Google Language</a>
queryqueryalln/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 comparisons
regionqueryn/aallstringRefines results for region charts. Supported values: 'COUNTRY', 'REGION', 'DMA', 'CITY'
tzqueryn/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.

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.