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>
{
"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"
}
]
}
]
}
}
}
}
}{
"status": "error",
"msg": "validation_error",
"error": {
"id": [
"The id field is required."
]
}
}{
"status": "error",
"msg": "Invalid ID provided.",
"error": ""
}{
"status": "error",
"msg": "Keyword is not processed yet.",
"error": ""
}{
"status": "error",
"msg": "not found",
"error": ""
}{
"status": "error",
"msg": "Unauthenticated"
}Example request:
curl --location --request GET 'https://api.serphouse.com/trends/get?id=76850016' \
--header 'Authorization: Bearer <YOUR_API_KEY>'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
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)
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
$serphouse = new SERPHouse\SERPHouseClient('YOUR_API_KEY');
$res = $serphouse->trends->get(76850016);
echo $res->getResponse();
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());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));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))
}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);Last updated