SERPHouse API is the starting point on your journey towards building a powerful SEO software. With SERPHouse you can get all the data you’d need to build an efficient application while also saving your time and your budget.
This comprehensive document designed to provide you with all the technical information as well as product information you need to interact with our API and harness its full potential. Whether you're a software developer integrating SERPHouse SERP API services into your application or a curious user exploring the possibilities, this API documentation will serve as your go-to resource.
High Volume SERP API for SEO professionals and data scientist. We built reliable, accurate and cost efficient solution, We take cares of resolving captcha, managing proxy to ensure you get reliable Structured JSON data.
This API supported Serphouse's standard REST API that accepts/returns JSON requests. Here is the API reference
Using the Serphouse API wrapper for PHP is straightforward. Follow these steps to integrate it into your project:
Documentation for Serphouse's API and its usage is available at https://docs.serphouse.com/
- PHP >= 7.2
You can install the Serphouse PHP package via Composer. Run the following command in your project directory:
composer require serphouse/serphouse-phpyou need to load the dependency in your script.
<?php
require __DIR__ . '/vendor/autoload.php';
?>After installing the package, you can set up the Serphouse client in your code like this:
<?php
use Serphouse\SERPHouseClient;
$serphouse = new SERPHouseClient('YOUR_API_KEY');Replace 'YOUR_API_KEY' with your actual Serphouse API key.
You can obtain an API key by registering at https://app.serphouse.com/register. This key will be required for accessing the API.
1. SERP Live
$serphouse->serpApi->live([
'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',
],
]);If you need to get response by responseType HTML or Json then you can use Like Below Example:
$serphouse->serpApi->live('DATA_ARRAY','responseType'); // default responseType is Json2. SERP Schedule
$serphouse->serpApi->schedule([
"data" => [
[
"q" => "Coffee",
"domain" => "google.com",
"lang" => "en",
"device" => "desktop",
"serp_type" => "web",
"loc" => "Alba,Texas,United States",
"verbatim" => 0,
"postback_url" => "Webhook_url",
"pingback_url" => "Webhook_url",
"page" => 1,
"num_result" => 10
]
]
]);3. SERP Check
$serphouse->serpApi->check('SERP_ID');4. SERP Get
$serphouse->serpApi->get('SERP_ID');If you need to get response by responseType HTML or Json then you can use like below example:
$serphouse->serpApi->get('SERP_ID','responseType'); // default responseType is Json1. Get Domains List
$serphouse->domains->list();1. Get Languages List
$serphouse->languages->list();If you need to get Languages List by google, bing and yahoo then you can use like below example:
$serphouse->languages->list(['type'=> 'bing']); // default type is google1. Get Locations List
$serphouse->location->search(['q'=> 'texas']);If you need to get Locations List by google, bing and yahoo then you can use like below example:
$serphouse->languages->search(['q'=> 'texas','type'=> 'bing']); // default type is google1. Get Account Information
$serphouse->account->fetch();1. Trend Search
$serphouse->trends->search([
'time_zone_offset' => '-330',
'keywords' => 'google,youtube',
'time' => 'now 1-d',
'property' => 'youtube',
'category' => '0',
'geo' => 'us',
'language_code' => 'en'
]);2. Trend Schedule
$serphouse->trends->schedule([
"data" => [
[
"time_zone_offset" => -330,
"keywords" => "google",
"time" => "now 1-d",
"property" => "youtube",
"category" => 0,
"geo" => "us",
"language_code" => "en",
"postback_url" => "Webhook_url",
"pingback_url" => "Webhook_url"
]
]
]);3. Get TimeZone List
$serphouse->trends->timeZoneList();4. Get Categories List
$serphouse->trends->categoryList();5. Get Country and State List
$serphouse->trends->countryStateList();6. Get Language List
$serphouse->trends->languageList();7. Trends Check
$serphouse->trends->check('TRENDS_ID');8. Trends Get
$serphouse->trends->get('TRENDS_ID');Example of success response.
SERPHouse\Services\Handlers\Responses Object
(
[statusCode:SERPHouse\Services\Handlers\Responses:private] => 200
[response:SERPHouse\Services\Handlers\Responses:private] => {"status":"success","msg":"Completed","search_metadata":{"id":128078258,"status":"success","created_at":"2024-05-04T06:20:10.000000Z","processed_at":"2024-05-04 06:20:10"},"search_parameters":{"langauge_code":"en-US","geo":"US","keywords":"google,youtube","time_zone_offset":"-330","time":"now 1-d","category":0,"property":"youtube"},"results":{"TIMESERIES":[{"time":"1714716960","formattedTime":"May 3, 2024 at 11:46 AM","formattedAxisTime":"May 3 at 11:46 AM","value":[19,72],"hasData":[true,true],"formattedValue":["19","72"]}],"GEO_MAP":{"google":{"default":{"geoMapData":[{"geoCode":"US-VT","geoName":"Vermont","value":[100],"formattedValue":["100"],"maxValueIndex":0,"hasData":[true]}]}},"youtube":{"default":{"geoMapData":[{"geoCode":"US-NH","geoName":"New Hampshire","value":[100],"formattedValue":["100"],"maxValueIndex":0,"hasData":[true]}]}}},"RELATED_QUERIES":{"google":{"default":{"rankedList":[{"rankedKeyword":[{"query":"google link","value":100,"formattedValue":"100","hasData":true,"link":"/trends/explore?q=google+link&date=now+1-d&geo=US"}]},{"rankedKeyword":[{"query":"the man who killed google search","value":1650,"formattedValue":"+1,650%","link":"/trends/explore?q=the+man+who+killed+google+search&date=now+1-d&geo=US"}]}]}},"youtube":{"default":{"rankedList":[{"rankedKeyword":[{"query":"on youtube","value":100,"formattedValue":"100","hasData":true,"link":"/trends/explore?q=on+youtube&date=now+1-d&geo=US"}]},{"rankedKeyword":[{"query":"jayson tatum youtube channel","value":5300,"formattedValue":"Breakout","link":"/trends/explore?q=jayson+tatum+youtube+channel&date=now+1-d&geo=US"}]}]}}}}}
[errorMessage:SERPHouse\Services\Handlers\Responses:private] =>
)
Example of validation errors response.
SERPHouse\Services\Handlers\Responses Object
(
[statusCode:SERPHouse\Services\Handlers\Responses:private] => 400
[response:SERPHouse\Services\Handlers\Responses:private] => {"status":"error","msg":"validation_error","error":{"time_zone_offset":["The time zone offset field is required."]}}
[errorMessage:SERPHouse\Services\Handlers\Responses:private] => Client error: `POST https://api.serphouse.com/trends/search` resulted in a `400 Bad Request` response:
{"status":"error","msg":"validation_error","error":{"time_zone_offset":["The time zone offset field is required."]}}
)
You need to manage the response.
-
get response status code using
getStatusCode()function$response->getStatusCode()
-
get response using
getResponse()function and you will get Json string$response->getResponse()
-
get error message using
getErrorMessage()function and you will get Json string$response->getErrorMessage()
This exception is thrown when the requested call is not found.
This exception is thrown when payment is required to access the requested call.
This exception is thrown when the rate limit for API requests has been exceeded in the SERP House API. For more information about rate limit check this https://docs.serphouse.com/introduction/rate-limits
This exception is thrown when there is an internal server error.
This exception is thrown when the request is unauthorized to access the requested call or Invalid API Key.