Create up to 1000 Search Engine Ranking Page (SERP) requests from a list.

post

https://api.highvolume.georanker.com/serp/new/list

Create up to 1000 SERPs requests, that are asynchronous by default, and receive a list of incomplete SERP objects, where their IDs can be used to download the respective full data, later.
Click here and check out a JSON response example.

ABOUT THE CREDIT SYSTEM
The base value for every SERP request is 1 CREDIT, but this value can change based on the following parameters:

Priority
Max Results
Search Engine

Priority (multipliers):

LOW PRIORITY = multiplies costs by 1
NORMAL PRIORITY = multiplies costs by 1
REALTIME PRIORITY = multiplies costs by 2
INSTANT PRIORITY = multiplies costs by 3

Max Results:

Credits can increase as maxResults grows, based on incremental
pricing rules configured for your account.

Search Engine:
The costs can change depending on the search engine, based on credit rules configured for your account.

LIMITS AND RULES
Our API has a few limitations depending on your plan, you can see more about this on our onboarding page here. Please get in touch with us for any further information or questions.

Rules:
Our API has two different policies when the limits are exceeded:

Overcharge: The system will allow you to continue using the API but every request above the limit will cost extra. (prices and what policy is used depends on your plan and agreement)
Reject: The system will reject any further request after the limit is exceeded (prices and what policy is used depends on your plan and agreement)

NOTE 1: Every SERP request will have its callback called separately.
NOTE 2: To use the custom region search, do not set the region parameter, otherwise the region will be used by default.

Responses

`ready` will be false for that object and the data field object may be null. This function ignores the SERPs that do not exist or are duplicated.

Language

Credentials

Query

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A list of Full SERP data that was created. If the data is not ready yet for a specific SERP, the flag ready will be false for that object and the data field object may be null. This function ignores the SERPs that do not exist or are duplicated.

402Credit limit exceeded or insufficient credits. The user exceeded their available hourly or daily requests and should try again later. Or the user account has no credits left to complete the request.

403Bad API Key. Your key may have been mistyped or you do not have access to our API. Retrying the request will not solve the issue.

429Too many requests or connections. Your server made too many requests or opened too many connections. Please slow it down and close the unused connections. Enabling the 'keep-alive' mechanism may help to reuse connections.

500Internal server error. This is a generic error for some unexpected action that might happen at our side. This error should never appear to you, but if it does, you should retry later and contact us if it persists.

502Internal server error due a database timeout. This error should never appear to you, but if it does, you should retry later and contact us if it persists.

504Internal server error similar to error 502. This error should never appear to you, but if it does, you should retry later and contact us if it persists.

`ready` will be false for that object and the data field object may be null. This function ignores the SERPs that do not exist or are duplicated.