Google Trends

Search

Get Google trends Search data, including interest over time, geo breakdowns, and related queries, for demand analysis and seasonal trend monitoring.

get/api/v1/google/trends/search

Request

  • Base URL: http://api.justserpapi.com
  • URL: http://api.justserpapi.com/api/v1/google/trends/search
  • Auth: none declared

Query parameters

querystring required

The 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.

languagestring

Set 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>.

geostring

The 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>.

region'COUNTRY' | 'REGION' | 'DMA' | 'CITY'

Google Trends region chart refinement.

Refines results for region charts.

Available Values:

  • COUNTRY: Country-level results.
  • REGION: Region-level results.
  • DMA: Designated market area results.
  • CITY: City-level results.
data_type'INTEREST_OVER_TIME' | 'REGION_BREAKDOWN'

Google Trends data type.

The type of trend data to retrieve.

Available Values:

  • INTEREST_OVER_TIME: Interest over time. Legacy value TIMESERIES is also accepted.
  • REGION_BREAKDOWN: Breakdown by region. Legacy value GEO_MAP is also accepted.
tzinteger

Time zone offset in minutes (e.g., '420' for PDT). Range: -1439 to 1439.

catstring

The search category code (e.g., '0' for all categories).

gprop'IMAGES' | 'NEWS' | 'SHOPPING' | 'YOUTUBE'

Google Trends property filter.

The Google property to filter trends.

Available Values:

  • IMAGES: Google Images. Legacy value images is also accepted.
  • NEWS: Google News. Legacy value news is also accepted.
  • SHOPPING: Google Shopping. Legacy value froogle is also accepted.
  • YOUTUBE: YouTube. Legacy value youtube is also accepted.
datestring

Date 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).

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.