Home Pricing API Playground Login

Live (Using HTTP POST method)

Performing a realtime search using HTTP POST is very simple to the SERPHouse live endpoint.

Requires authentication

POST https://api.serphouse.com/serp/live

Path Parameters

NameTypeDescription

responseType

String

responseType can be 'html' or 'json'

Headers

NameTypeDescription

Authorization*

String

Bearer <YOUR_API_KEY>

Content-Type*

String

application/json

Request Body

NameTypeDescription

q*

string

Search phrase that you want to search

domain*

string

Choose google ,bing or yahoo domain.

You can get the list of available search engines by making a separate request to the List of Search Engines

lang*

string

You can set language for e.g. en for english fr for french. Get the list of available languages by making a separate request to the List of Language

device*

string

Device can be desktop To extract desktop result tablet To extract tablet result mobile To extract mobile result

serp_type*

string

Serp type can be web Get structured json result search engines web result

news Get news result from search engines image Search image over searchengines and get json result

shop Get a results of a Google Shopping search from search engines

loc*

string

Optional field if you specify loc_id when choose yahoo domain then field is optional You must choose one of the fields: loc_id or loc You can receive the list of available locations of search engines with their loc_id by making a separate request to the List of Locations

loc_id*

integer

Optional field if you specify loc you must choose one of the fields: loc_id or loc You can receive the list of available locations of search engines with their loc_id by making a separate request to the List of Locations

verbatim

integer

Set Google Verbatim search, Parameter value can be 0 or 1

gfilter

integer

Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to 1 (default) to enable these filters, or 0 to disable these filters.

page

integer

Give specific page to get the result of that page number. By default it will get you first page.

num_result

integer

Define number of result you want to get per page. By default you will get top 100 results.

date_range

String

Sometimes you may want to only find information published during a specific time frame. To limit Google results by date

Parameter values can be comma seprated date range YYYY-MM-DD,YYYY-MM-DD OR

h Past hour

d Past 24 hours

w Past week

m Past month

y Past year 

{
    "status": "error",
    "msg": "Please try again",
    "error": ""
}

, Example request:

curl --location --request 'https://api.serphouse.com/serp/live' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "q" : "apple",
        "domain" : "google.com",
        "lang" : "en",
        "device" : "desktop",
        "serp_type" : "web",
        "loc" : "Alba,Texas,United States",
        "loc_id" : "1026201",
        "verbatim" : "0",
        "gfilter" : "0",
        "page" : "1",
        "num_result" : "10"
    }
}'
PreviousLive (Using HTTP GET method)NextSchedule SERP

Last updated