Check Search Status

As a response of the API server, you will get a status of your trend search task.

Requires authentication

Get a status of your trend search task

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

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 Completed operation

{
    "status": "success",
    "msg": "Completed",
    "results": ""
}

400: Bad Request Failed validation

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

404: Not Found Failed operation

{
    "status": "success",
    "msg": "Not found",
    "results": ""
}

200: OK Processing in a queue

{
    "status": "success",
    "msg": "Processing in a queue",
    "results": ""
}

200: OK Waiting for a process

{
    "status": "success",
    "msg": "Waiting for a process",
    "results": ""
}

401: Unauthorized Unauthenticated

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

Example request:

BASH

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

RUBY

require "uri"
require "net/http"

url = URI("https://api.serphouse.com/trends/check?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/check?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/check?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->check(76850016);
echo $res->getResponse();

JAVA

OkHttpClient client = new OkHttpClient().newBuilder().build();
Request request = new Request.Builder()
  .url("https://api.serphouse.com/trends/check?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/check?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/check?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/check?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);