Get Search Result

As a response of the API server, you will receive an json array containing a result of your trend search query.

Requires authentication

Get a trend search

GET https://api.serphouse.com/trends/get

Query Parameters

Name	Type	Description
id*	String	unique identifier of your serp task

Headers

Name	Type	Description
Authorization*	String	Bearer <YOUR_API_KEY>

200: OK Successful operation

{
    "status": "success",
    "msg": "",
    "results": {
        "search_metadata": {
            "id": 76850016,
            "status": "success",
            "created_at": "2023-05-27T07:08:11.000000Z",
            "processed_at": "2023-05-27 07:08:23"
        },
        "search_parameters": {
            "langauge_code": "en",
            "geo": "US",
            "keywords": "google",
            "time_zone_offset": "-330",
            "time": "now 1-d",
            "category": 0,
            "property": "youtube"
        },
        "result": {
            "TIMESERIES": [
                {
                    "time": "1685085120",
                    "formattedTime": "May 26, 2023 at 12:42 PM",
                    "formattedAxisTime": "May 26 at 12:42 PM",
                    "value": [
                        51
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "51"
                    ]
                },
                {
                    "time": "1685085600",
                    "formattedTime": "May 26, 2023 at 12:50 PM",
                    "formattedAxisTime": "May 26 at 12:50 PM",
                    "value": [
                        66
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "66"
                    ]
                },
                {
                    "time": "1685086080",
                    "formattedTime": "May 26, 2023 at 12:58 PM",
                    "formattedAxisTime": "May 26 at 12:58 PM",
                    "value": [
                        66
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "66"
                    ]
                },
                {
                    "time": "1685086560",
                    "formattedTime": "May 26, 2023 at 1:06 PM",
                    "formattedAxisTime": "May 26 at 1:06 PM",
                    "value": [
                        64
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "64"
                    ]
                },
                {
                    "time": "1685087040",
                    "formattedTime": "May 26, 2023 at 1:14 PM",
                    "formattedAxisTime": "May 26 at 1:14 PM",
                    "value": [
                        70
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "70"
                    ]
                },
                {
                    "time": "1685087520",
                    "formattedTime": "May 26, 2023 at 1:22 PM",
                    "formattedAxisTime": "May 26 at 1:22 PM",
                    "value": [
                        54
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "54"
                    ]
                },
                {
                    "time": "1685088000",
                    "formattedTime": "May 26, 2023 at 1:30 PM",
                    "formattedAxisTime": "May 26 at 1:30 PM",
                    "value": [
                        60
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "60"
                    ]
                },
                {
                    "time": "1685088480",
                    "formattedTime": "May 26, 2023 at 1:38 PM",
                    "formattedAxisTime": "May 26 at 1:38 PM",
                    "value": [
                        74
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "74"
                    ]
                },
                {
                    "time": "1685088960",
                    "formattedTime": "May 26, 2023 at 1:46 PM",
                    "formattedAxisTime": "May 26 at 1:46 PM",
                    "value": [
                        59
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "59"
                    ]
                },
                {
                    "time": "1685089440",
                    "formattedTime": "May 26, 2023 at 1:54 PM",
                    "formattedAxisTime": "May 26 at 1:54 PM",
                    "value": [
                        91
                    ],
                    "hasData": [
                        true
                    ],
                    "formattedValue": [
                        "91"
                    ]
                }
            ],
            "GEO_MAP": {
                "google": {
                    "default": {
                        "geoMapData": [
                            {
                                "geoCode": "US-ND",
                                "geoName": "North Dakota",
                                "value": [
                                    100
                                ],
                                "formattedValue": [
                                    "100"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            },
                            {
                                "geoCode": "US-RI",
                                "geoName": "Rhode Island",
                                "value": [
                                    100
                                ],
                                "formattedValue": [
                                    "100"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            },
                            {
                                "geoCode": "US-ID",
                                "geoName": "Idaho",
                                "value": [
                                    89
                                ],
                                "formattedValue": [
                                    "89"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            },
                            {
                                "geoCode": "US-CT",
                                "geoName": "Connecticut",
                                "value": [
                                    89
                                ],
                                "formattedValue": [
                                    "89"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            },
                            {
                                "geoCode": "US-NH",
                                "geoName": "New Hampshire",
                                "value": [
                                    87
                                ],
                                "formattedValue": [
                                    "87"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            },
                            {
                                "geoCode": "US-SD",
                                "geoName": "South Dakota",
                                "value": [
                                    85
                                ],
                                "formattedValue": [
                                    "85"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            },
                            {
                                "geoCode": "US-MT",
                                "geoName": "Montana",
                                "value": [
                                    84
                                ],
                                "formattedValue": [
                                    "84"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            },
                            {
                                "geoCode": "US-UT",
                                "geoName": "Utah",
                                "value": [
                                    83
                                ],
                                "formattedValue": [
                                    "83"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            },
                            {
                                "geoCode": "US-NM",
                                "geoName": "New Mexico",
                                "value": [
                                    83
                                ],
                                "formattedValue": [
                                    "83"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            },
                            {
                                "geoCode": "US-KS",
                                "geoName": "Kansas",
                                "value": [
                                    81
                                ],
                                "formattedValue": [
                                    "81"
                                ],
                                "maxValueIndex": 0,
                                "hasData": [
                                    true
                                ]
                            }
                        ]
                    }
                }
            },
            "RELATED_QUERIES": {
                "default": {
                    "rankedList": [
                        {
                            "rankedKeyword": [
                                {
                                    "query": "google maps",
                                    "value": 100,
                                    "formattedValue": "100",
                                    "hasData": true,
                                    "link": "/trends/explore?q=google+maps&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google pixel",
                                    "value": 82,
                                    "formattedValue": "82",
                                    "hasData": true,
                                    "link": "/trends/explore?q=google+pixel&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google play",
                                    "value": 79,
                                    "formattedValue": "79",
                                    "hasData": true,
                                    "link": "/trends/explore?q=google+play&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google link",
                                    "value": 71,
                                    "formattedValue": "71",
                                    "hasData": true,
                                    "link": "/trends/explore?q=google+link&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "hey google hey google",
                                    "value": 62,
                                    "formattedValue": "62",
                                    "hasData": true,
                                    "link": "/trends/explore?q=hey+google+hey+google&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "hey google",
                                    "value": 61,
                                    "formattedValue": "61",
                                    "hasData": true,
                                    "link": "/trends/explore?q=hey+google&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google me",
                                    "value": 55,
                                    "formattedValue": "55",
                                    "hasData": true,
                                    "link": "/trends/explore?q=google+me&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google song",
                                    "value": 45,
                                    "formattedValue": "45",
                                    "hasData": true,
                                    "link": "/trends/explore?q=google+song&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google chrome",
                                    "value": 44,
                                    "formattedValue": "44",
                                    "hasData": true,
                                    "link": "/trends/explore?q=google+chrome&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google ok google",
                                    "value": 43,
                                    "formattedValue": "43",
                                    "hasData": true,
                                    "link": "/trends/explore?q=google+ok+google&date=now+1-d&geo=US"
                                }
                            ]
                        },
                        {
                            "rankedKeyword": [
                                {
                                    "query": "gogglebox",
                                    "value": 3150,
                                    "formattedValue": "+3,150%",
                                    "link": "/trends/explore?q=gogglebox&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "oye google",
                                    "value": 600,
                                    "formattedValue": "+600%",
                                    "link": "/trends/explore?q=oye+google&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google earth iceberg",
                                    "value": 350,
                                    "formattedValue": "+350%",
                                    "link": "/trends/explore?q=google+earth+iceberg&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google maps iceberg",
                                    "value": 300,
                                    "formattedValue": "+300%",
                                    "link": "/trends/explore?q=google+maps+iceberg&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google maps offline",
                                    "value": 250,
                                    "formattedValue": "+250%",
                                    "link": "/trends/explore?q=google+maps+offline&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google sge",
                                    "value": 250,
                                    "formattedValue": "+250%",
                                    "link": "/trends/explore?q=google+sge&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "how to go on google on ps5",
                                    "value": 200,
                                    "formattedValue": "+200%",
                                    "link": "/trends/explore?q=how+to+go+on+google+on+ps5&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google maps anomaly iceberg",
                                    "value": 160,
                                    "formattedValue": "+160%",
                                    "link": "/trends/explore?q=google+maps+anomaly+iceberg&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google easter eggs",
                                    "value": 150,
                                    "formattedValue": "+150%",
                                    "link": "/trends/explore?q=google+easter+eggs&date=now+1-d&geo=US"
                                },
                                {
                                    "query": "google adwords tutorial for beginners",
                                    "value": 140,
                                    "formattedValue": "+140%",
                                    "link": "/trends/explore?q=google+adwords+tutorial+for+beginners&date=now+1-d&geo=US"
                                }
                            ]
                        }
                    ]
                }
            },
            "RELATED_TOPICS": {
                "default": {
                    "rankedList": [
                        {
                            "rankedKeyword": [
                                {
                                    "topic": {
                                        "mid": "/m/0387r",
                                        "title": "Google Search",
                                        "type": "Website"
                                    },
                                    "value": 100,
                                    "formattedValue": "100",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/m/0387r&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/04_tb",
                                        "title": "Map",
                                        "type": "Topic"
                                    },
                                    "value": 27,
                                    "formattedValue": "27",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/m/04_tb&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/055t58",
                                        "title": "Google Maps",
                                        "type": "Website"
                                    },
                                    "value": 25,
                                    "formattedValue": "25",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/m/055t58&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/g/11cm05x9g0",
                                        "title": "Google Pixel",
                                        "type": "Mobile phone"
                                    },
                                    "value": 19,
                                    "formattedValue": "19",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/g/11cm05x9g0&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/g/11c1txwz0_",
                                        "title": "Pixel",
                                        "type": "Mobile phone"
                                    },
                                    "value": 17,
                                    "formattedValue": "17",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/g/11c1txwz0_&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/05n02d2",
                                        "title": "Google Play",
                                        "type": "Topic"
                                    },
                                    "value": 15,
                                    "formattedValue": "15",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/m/05n02d2&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/02p9w51",
                                        "title": "Google Account",
                                        "type": "Topic"
                                    },
                                    "value": 13,
                                    "formattedValue": "13",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/m/02p9w51&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/010x3c2k",
                                        "title": "Google Sheets",
                                        "type": "Topic"
                                    },
                                    "value": 11,
                                    "formattedValue": "11",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/m/010x3c2k&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/012mqx",
                                        "title": "Iceberg",
                                        "type": "Topic"
                                    },
                                    "value": 11,
                                    "formattedValue": "11",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/m/012mqx&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/03l68z",
                                        "title": "Google Ads",
                                        "type": "Topic"
                                    },
                                    "value": 11,
                                    "formattedValue": "11",
                                    "hasData": true,
                                    "link": "/trends/explore?q=/m/03l68z&date=now+1-d&geo=US"
                                }
                            ]
                        },
                        {
                            "rankedKeyword": [
                                {
                                    "topic": {
                                        "mid": "/m/030zfn",
                                        "title": "Parallel",
                                        "type": "Geometry"
                                    },
                                    "value": 1350,
                                    "formattedValue": "+1,350%",
                                    "link": "/trends/explore?q=/m/030zfn&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/012mqx",
                                        "title": "Iceberg",
                                        "type": "Topic"
                                    },
                                    "value": 350,
                                    "formattedValue": "+350%",
                                    "link": "/trends/explore?q=/m/012mqx&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/047vnn4",
                                        "title": "Gift card",
                                        "type": "Topic"
                                    },
                                    "value": 120,
                                    "formattedValue": "+120%",
                                    "link": "/trends/explore?q=/m/047vnn4&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/03s3lh",
                                        "title": "Fibre-reinforced plastic",
                                        "type": "Topic"
                                    },
                                    "value": 70,
                                    "formattedValue": "+70%",
                                    "link": "/trends/explore?q=/m/03s3lh&date=now+1-d&geo=US"
                                },
                                {
                                    "topic": {
                                        "mid": "/m/05p_8g",
                                        "title": "Tag",
                                        "type": "Metadata"
                                    },
                                    "value": 40,
                                    "formattedValue": "+40%",
                                    "link": "/trends/explore?q=/m/05p_8g&date=now+1-d&geo=US"
                                }
                            ]
                        }
                    ]
                }
            }
        }
    }
}

400: Bad Request Failed validation

{
    "status": "error",
    "msg": "validation_error",
    "error": {
        "id": [
            "The id field is required."
        ]
    }
}

400: Bad Request Failed operation

{
    "status": "error",
    "msg": "Invalid ID provided.",
    "error": ""
}

404: Not Found Failed operation

{
    "status": "error",
    "msg": "Keyword is not processed yet.",
    "error": ""
}

404: Not Found Failed operation

{
    "status": "error",
    "msg": "not found",
    "error": ""
}

401: Unauthorized Unauthenticated

{
    "status": "error",
    "msg": "Unauthenticated"
}

Example request:

BASH

curl --location --request GET 'https://api.serphouse.com/trends/get?id=76850016' \
--header 'Authorization: Bearer <YOUR_API_KEY>'

RUBY

require "uri"
require "net/http"

url = URI("https://api.serphouse.com/trends/get?id=76850016")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer <YOUR_API_KEY>"

response = https.request(request)
puts response.read_body

PYTHON

import requests

url = "https://api.serphouse.com/trends/get?id=76850016"

payload={}
headers = {
  'Authorization': 'Bearer <YOUR_API_KEY>'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

NODE.JS

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://api.serphouse.com/trends/get?id=76850016',
  headers: { 
    'Authorization': 'Bearer <YOUR_API_KEY>'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

PHP

<?php
$serphouse = new SERPHouse\SERPHouseClient('YOUR_API_KEY');
$res = $serphouse->trends->get(76850016);
echo $res->getResponse();

JAVA

OkHttpClient client = new OkHttpClient().newBuilder().build();
Request request = new Request.Builder()
  .url("https://api.serphouse.com/trends/get?id=76850016")
  .get()
  .addHeader("Authorization", "Bearer <YOUR_API_KEY>")
  .build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());

JAVASCRIPT

var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer <YOUR_API_KEY>");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://api.serphouse.com/trends/get?id=76850016", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

GO

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.serphouse.com/trends/get?id=76850016"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

C#/.NET

var client = new RestClient("https://api.serphouse.com/trends/get?id=76850016");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <YOUR_API_KEY>");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);