PHP SDK

The official PHP SDK makes it easy to integrate the SERPHouse API into any PHP application.

It provides a clean interface for:

• Google SERP searches

• Scheduled SERP jobs

• Account information

• Supported domains

• Languages

• Locations

Instead of manually building HTTP requests, you interact with PHP methods while the SDK handles authentication and API communication.

SERPHouse PHP SDK on GitHub

SERPHouse PHP SDK on Packagist

---

Requirements

• PHP 7.2+

• Composer

---

Installation

Install using Composer.

composer require serphouse/serphouse-php

---

Get your API Key

Create a SERPHouse account and generate an API key from your dashboard.

Initialize the Client

require 'vendor/autoload.php';
use Serphouse\SERPHouseClient;
$client = new SERPHouseClient('YOUR_API_KEY');

That's all that's required before calling any endpoint.

---

Live SERP Search

Retrieve Google search results instantly.

$response = $client->serpApi->live([
    'data' => [
        'q' => 'apple',
        'domain' => 'google.com',
        'lang' => 'en',
        'device' => 'desktop',
        'serp_type' => 'web',
        'loc' => 'Texas, United States',
        'page' => 1,
        'num_result' => 10,
    ]
]);

---

Schedule a Search

Instead of waiting for results immediately, schedule a search.

$response = $client->serpApi->schedule([
    'data' => [
        [
            'q' => 'Coffee',
            'domain' => 'google.com',
            'lang' => 'en',
            'device' => 'desktop',
            'serp_type' => 'web',
            'loc' => 'Texas, United States',
            'postback_url' => '...',
            'pingback_url' => '...',
        ]
    ]
]);

---

Check Search Status

$response = $client->serpApi->check($searchId);

---

Get Search Result

$response = $client->serpApi->get($searchId);

Return HTML instead of JSON:

$response = $client->serpApi->get($searchId, 'html');

---

Domains

$response = $client->domains->list();

---

Languages

$response = $client->languages->list();

For Bing:

$response = $client->languages->list([
    'type' => 'bing'
]);

---

Locations

$response = $client->location->search([
    'q' => 'Texas'
]);

---

Account

$response = $client->account->fetch();

---

Working with Responses

Every SDK call returns a Responses object.

Retrieve the HTTP status code:

$response->getStatusCode();

Retrieve the API response:

$response->getResponse();

Retrieve the error message:

$response->getErrorMessage();

---

Exception Handling

The SDK throws dedicated exception classes for common API errors.

try {
    $response = $client->serpApi->live(...);
} catch (SERPHouseUnauthorizedException $e) {

}

catch (SERPHouseRateLimitExceededException $e) {

}

catch (SERPHouseServerErrorException $e) {

}

Supported exceptions include:

• SERPHouseUnauthorizedException

• SERPHouseRateLimitExceededException

• SERPHousePaymentRequiredException

• SERPHouseNotFoundException

• SERPHouseServerErrorException

---

Support

If you encounter any issues while installing, configuring, or using the SERPHouse PHP SDK, we're here to help.

• Contact the SERPHouse support team for assistance.

• Report bugs or request features by opening an issue on the GitHub repository.

GitHub Repository:

https://github.com/SERPHouse/serphouse-php