Getting Started
Authentication, registration, HTTP status codes, and rate limits for the SERPHouse API.
Registration
To create a new account at SERPHouse is a easy and quick to get into the system, Simply navigate to the Sign Up page and use one of the available sign-up options. You will have access to API Playground and other learning resources.
Our system allows single account per user. If you need more testing credits, contact our support at [email protected].
Authentication
Create an account with SERPHouse and once you confirm your email, you will be able to see an API key on your account dashboard.
API Key
The API key for SERPHouse API is available after registration and confirming a email. In our documentation, We will refer to the API key by using the following syntax: <YOUR_API_KEY>
Passing the API key as a parameter is required in order to authorise your requests. Failing to pass an API key or passing an invalid API key will result in an error.
Keep your key secure
Your API key will directly impact the usage on your subscription plan. In order to prevent unauthorized access to your SERPHouse account, make sure you store your API key in a secure location and never include it in any public scripts or files.
Authentication Examples
A Bearer Token is set in the Authorization header of every HTTP Request:
POST /serp/live HTTP/1.1
Host: https://api.serphouse.com
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/jsonAlternatively, our API allows authentication by passing api_token as a query string in every HTTP request:
GET /location/search?q=united&type=google&api_token=<YOUR_API_KEY> HTTP/1.1
Host: api.serphouse.comHTTP Status Codes
| Code | Description |
|---|---|
| 200 | Request executed successfully. SERP data available in the results field. |
| 400 | Invalid request body. Validation error. Check error details in the response. |
| 401 | Unauthenticated. Check your API key and ensure it is sent as a Bearer token in the Authorization header. |
| 402 | Insufficient credits. Your account has run out of available credits, or there is a payment issue. |
| 404 | Endpoint not found. You may have provided an invalid SERP ID in Get or Check API. |
| 405 | Method not allowed. Check the HTTP method used in your request. |
| 429 | Rate limit exceeded. Slow down your request rate. |
| 500 | Internal server error. Our team is notified automatically. |
2xx only means success
Only HTTP 200 indicates a successful request. All other status codes indicate an error that needs to be addressed.
Response format
In some cases, a 200 status may also return this error retry the request after some time.
{
"status": "error",
"msg": "Please try again",
"error": ""
}Rate Limits
A rate limit is the number of API calls an app or user can make within a given time period. If this limit is exceeded or if CPU or total time limits are exceeded, the app or user may be throttled. API requests made by a throttled user or api will fail.
All API requests are subject to rate limits.
Need a higher limit?
Contact us at [email protected] if you are on a custom monthly plan and need to increase your rate limit.
Standard Rate Limit
| Plan | Rate limit |
|---|---|
| Free plan | 60 req/min |
| Basic | 60 req/min |
| Regular | 60 req/min |
| Custom Plan | As needed |
Rate limits are calculated per minute.
Pricing
| Free | Basic | Regular | Custom | |
|---|---|---|---|---|
| Price | $0 / month | $29.99 / month | $49.99 / month | Custom |
| API credits | 4,000 | 400,000 | 800,000 | Custom |
| SERP requests (per 1k) | — | $0.75 | $0.62 | Custom |
| Auto Complete requests (per 1k) | — | $0.37 | $0.31 | Custom |
| Top 100 Google SERP (per 1k) | — | $7.50 | $6.25 | Custom |
| Google, Bing & Yahoo data | Included | Included | Included | Included |
| HTTPS encryption | Included | Included | Included | Included |
| Monthly credit rollover | No | No | No | — |
| Uptime SLA | — | 99.95% | 99.95% | 99.95% |
| Success rate | — | 100% | 100% | 100% |
| Support | — | Priority | Dedicated | Dedicated |
| Concurrency | 60 | 60 | 60 | Custom |
Related Links
Last updated on
How is this guide?