Google Trends API

Stay on top of the market by scraping Google Trends in real time.

To enable this engine, set the engine=google_trends parameter.

Google trends is a tool that returns data about the popularity of search queries. Being able to scrape Google Trends can give you an advantage over your competition or can be used in various marketing campaigns.

Scrape Google Trends Page

Google Trends API Integration Example

We will use following URL as an example for this request:

https://serpapi.webscrapingapi.com/v2?engine=google_trends&api_key=<YOUR_API_KEY>&geo=US&q=american%20football&date=2021-01-01%202022-01-01

Ready to Use Google Trends API Scraping Scripts

cURL

curl --request GET --url "https://serpapi.webscrapingapi.com/v2?engine=google_trends&api_key=YOUR_API_KEY&geo=US&q=american%20football&date=2021-01-01%202022-01-01"

NodeJS

Python

PHP

Go

Java

.NET

Ruby

Google Trends API Parameters

#1: Query Parameter

Parameter	Type	Description
q	string	The keyword that you are searching for (the query).

#2: Request Customization Parameters

Parameter	Type	Description
geo	string	The location you want to find the results for. It defaults to worldwide. For a full list of supported geo options, feel free to check our list.
date	string	You must use the format YYYY-MM-DD YYYY-MM-DD or one of the predefined values: now 1-H, past 1 hour now 4-H, past 4 hours now 1-d, past day now 7-d, past 7 days today 1-m, past 30 days today 3-m, past 90 days today 12-m, past 12 months (default) today 5-y , past 5 years
cat	string	This is the category parameter. You can find the full list of Google Trends categories here.
gprop	string	This parameter specifies the Google property to filter on. Possible values are: images news froogle (for Google Shopping) youtube If unspecified, it defaults to web search.

Response Example

{
    "widgets": [
        {
            "data": {
                "default": {
                    "timelineData": [],
                    "averages": []
                }
            },
            "id": "TIMESERIES",
            "type": "fe_line_chart",
            "title": "Interest over time"
        },
        {
            "data": {
                "default": {
                    "geoMapData": [
                        {
                            "geoCode": "US-AK",
                            "geoName": "Alaska",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-AL",
                            "geoName": "Alabama",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-AR",
                            "geoName": "Arkansas",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-AZ",
                            "geoName": "Arizona",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-CA",
                            "geoName": "California",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-CO",
                            "geoName": "Colorado",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-CT",
                            "geoName": "Connecticut",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-DC",
                            "geoName": "District of Columbia",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-DE",
                            "geoName": "Delaware",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-FL",
                            "geoName": "Florida",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-GA",
                            "geoName": "Georgia",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-HI",
                            "geoName": "Hawaii",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-IA",
                            "geoName": "Iowa",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-ID",
                            "geoName": "Idaho",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-IL",
                            "geoName": "Illinois",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-IN",
                            "geoName": "Indiana",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-KS",
                            "geoName": "Kansas",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-KY",
                            "geoName": "Kentucky",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-LA",
                            "geoName": "Louisiana",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-MA",
                            "geoName": "Massachusetts",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-MD",
                            "geoName": "Maryland",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-ME",
                            "geoName": "Maine",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-MI",
                            "geoName": "Michigan",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-MN",
                            "geoName": "Minnesota",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-MO",
                            "geoName": "Missouri",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-MS",
                            "geoName": "Mississippi",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-MT",
                            "geoName": "Montana",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-NC",
                            "geoName": "North Carolina",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-ND",
                            "geoName": "North Dakota",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-NE",
                            "geoName": "Nebraska",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-NH",
                            "geoName": "New Hampshire",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-NJ",
                            "geoName": "New Jersey",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-NM",
                            "geoName": "New Mexico",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-NV",
                            "geoName": "Nevada",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-NY",
                            "geoName": "New York",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-OH",
                            "geoName": "Ohio",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-OK",
                            "geoName": "Oklahoma",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-OR",
                            "geoName": "Oregon",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-PA",
                            "geoName": "Pennsylvania",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-RI",
                            "geoName": "Rhode Island",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-SC",
                            "geoName": "South Carolina",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-SD",
                            "geoName": "South Dakota",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-TN",
                            "geoName": "Tennessee",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-TX",
                            "geoName": "Texas",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-UT",
                            "geoName": "Utah",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-VA",
                            "geoName": "Virginia",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-VT",
                            "geoName": "Vermont",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-WA",
                            "geoName": "Washington",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-WI",
                            "geoName": "Wisconsin",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-WV",
                            "geoName": "West Virginia",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        },
                        {
                            "geoCode": "US-WY",
                            "geoName": "Wyoming",
                            "value": [
                                0
                            ],
                            "formattedValue": [
                                ""
                            ],
                            "maxValueIndex": 0,
                            "hasData": [
                                false
                            ]
                        }
                    ]
                }
            },
            "id": "GEO_MAP",
            "type": "fe_geo_chart_explore",
            "title": "Interest by subregion"
        },
        {
            "data": {
                "default": {
                    "rankedList": [
                        {
                            "rankedKeyword": []
                        },
                        {
                            "rankedKeyword": []
                        }
                    ]
                }
            },
            "id": "RELATED_TOPICS",
            "type": "fe_related_searches",
            "title": "Related topics"
        },
        {
            "data": {
                "default": {
                    "rankedList": [
                        {
                            "rankedKeyword": []
                        },
                        {
                            "rankedKeyword": []
                        }
                    ]
                }
            },
            "id": "RELATED_QUERIES",
            "type": "fe_related_searches",
            "title": "Related queries"
        }
    ],
    "keywords": [
        {
            "keyword": "american%20football",
            "name": "american%20football",
            "type": "Search term"
        }
    ]
}