Trend Search

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

Requires authentication

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

Headers

NameTypeDescription

Authorization*

String

Bearer <YOUR_API_KEY>

Content-Type*

String

application/json

Request Body

NameTypeDescription

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.

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

Example request:

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"
}'