Trend Search

Performing a realtime google trends search using HTTP POST is very simple to the Google trend live endpoint.

Requires authentication

Performing a realtime google trends search.

POST https://api.serphouse.com/trends/search

Headers

Name	Type	Description
Authorization*	String	Bearer <YOUR_API_KEY>
Content-Type*	String	application/json

Request Body

Name	Type	Description
time_zone_offset*	integer	pass Timezone offset. You can receive the list of available timezone of google trend with their offset value by making a separate request to the List of timezone and offset
keywords*	string	Search keyword single google or multiple google,youtube,yahoo Note:- maximum 5 string search.
time*	string	now 1-H - Return past hour result now 4-H Return past 4 hours result now 1-d Return past 1 day result now 7-d Return past 7 days result today 1-m Return past 1 month result today 3-m Return past 3 months result today 12-m Return past 1 year result today 5-y Return past 5 years result 2021-01-24 2021-02-25 To extract custom date range result
property	string	property should contain bellow list only. "" - Web Search(Default) images - Image Search news - News Search froogle - Google Shopping youtube - YouTube Search
category	integer	by Default category is 0 for all categories. You can receive the list of available categories of google trend with their sub category by making a separate request to the List of Categories
geo	string	by Default geo is "" for Worldwide. You can receive the list of available geo of google trend with their state by making a separate request to the List of Country and State.
langauge_code	string	by Default language code is "en". You can receive the list of available language of google trend with their ids by making a separate request to the List of Language.

400: Bad Request Failed validation

{
    "status": "error",
    "msg": "validation_error",
    "error": {
        "time_zone_offset": [
            "The time zone offset field is required."
        ]
    }
}

402: Payment Required Failed operation

200: OK Successful operation

401: Unauthorized Unauthenticated

Example request:

BASH

curl --location --request POST 'https://api.serphouse.com/trends/search' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "time_zone_offset": "-330",
    "keywords": "google,youtube",
    "time": "now 1-d",
    "property": "youtube",
    "category": "0",
    "geo": "us",
    "langauge_code": "en"
}'

RUBY

PYTHON

NODE.JS

PHP

JAVA

JAVASCRIPT

GO

C#/.NET