SEO Data

API SEO Data is aimed at getting the TOP 100 SERP results from Google and Yandex for the key phrases (with URL, snipped, site’s position) without having an active project in SE Ranking.

One request to API SEO Data costs:

$0.003

Adding a keyword

Description

The method allows to add a query to the queue to obtain SERP results.

Parameters

NameRequiredDescription
queryYes Search query or a query array (a max number of characters in a query – 255)
engine_idYes
Unique search engine ID. A complete list of search engines and their unique IDs can be obtained via GET /system/search-engines (be sure to type in Google or Yandex)
region_nameNo
Name of region for search (only for the Google search engine)

region_idNo
Unique region ID for the Yandex search engine. You can get a complete list of regional IDs for Yandex via GET /system/yandex-regions

Request format

POST /parsing/serp/tasks
{
“engine_id”: 1,
“region_id”: 140,
“query”: “text”
or
“query”: [“text”, “text2”]
}
POST /parsing/serp/tasks
{
“engine_id”: 1,
“region_id”: 140,
“query”: “text”
or
“query”: [“text”, “text2”]
}

Result

If successful, the server returns the unique ID of every query added to the queue

NameRequiredDescription
task_idYesUnique query ID

Response example

[
{
“query”: :”text”,
“task_id”: 123456
}
]

Errors

HTTP codeError message
403Empty balance
400Invalid engine_id
400Invalid region_id
400Empty query
400 Query $query too long

Status verification and getting the verification results

Description

The method allows to get the result of a keyword that was previously added to the queue. If the keyword positions have not yet been recorded, the invoked method returns the status. The results are stored for 24 hours, then they are deleted.

Parameters

NameRequiredDescription
task_idYesUnique query ID

Unique query ID

GET /parsing/serp/tasks/{task_id}

Result

If successful, the server returns the query status.

If the query is in queue, the server returns the following status: processing.

Response example

{
“status”: “processing”
}

If the verification has been completed, the results of the verification are returned. If successful, the server returns an array containing the query results from the TOP 100 SERPs.

NameRequeryDescription
positionYes Page position in the TOP 100
urlYes URL of the page that’s ranked in the TOP 100
titleYes Title of the page in the TOP 100
snippetYes Description snippet of the page in the TOP 100
cache_urlNo Link to the cached copy of a page that’s ranked in the TOP 100

Response example

{
“results”: [
{
“position”: “1”,
“url”: “https://www.pizzahut.com/”,
“title”: “Pizza Hut: Pizza Delivery”,
“snippet”: “Order pizza online for fast delivery or carryout from a store near you. View our full menu, see nutritional information, find store locations, and more.“,
“cache_url”: “https://webcache.googleusercontent.com/search?q=cache:oiTvlHsuOeEJ:https://www.pizzahut.com/+&cd=4&hl=en&ct=clnk&gl=us”
},

“position”: “99”,
“url”: “https://techcrunch.com/2018/08/20/google-doctor-fork/”,
“title”: “Google created a fake pizza brand to test out creative strategies for …”,
“snippet”: “Aug 20, 2018 – Google’s Unskippable Labs team has been testing ad effectiveness in a compelling new way: It created a fake pizza brand called Doctor Fork, …“,
“cache_url”: “https://webcache.googleusercontent.com/search?q=cache:wi5sKCy0ResJ:https://techcrunch.com/2018/08/20/google-doctor-fork/+&cd=120&hl=en&ct=clnk&gl=us”
}
]
}

Errors

HTTP codeError message
404Task not found

List of all user queries

Description

The method allows to obtain a list of all user queries that were added to the queue in the last 24 hours.

Request format

GET /parsing/serp/tasks

Result

If successful, the server returns an array of queries that were added to the queue, and their statuses.

NameDescription
id Unique query ID
query Keyword or phrase (query)
region_name Name of region for search (only for the Google search engine)
engine_id
Unique search engine ID. A complete list of search engines and their unique IDs can be obtained via GET /system/search-engines (be sure to type in Google or Yandex)

region_id
Unique region ID for the Yandex search engine. You can get a complete list of regional IDs for Yandex via GET /system/yandex-regions

added
The date when the query was added to the queue.
is_completed Query verification status (1 – checked, 0 – no)

Response example

{
“tasks”: [
{
“id”: “18638740”,
“query”: “book”,
“region_name”: null,
“engine_id”: “411”,
“region_id”: “213”,
“added”: “2018-08-28 10:25:29”,
“is_completed”: “0”
},

{
“id”: “18639398”,
“query”: “pizza”,
“region_name”: “New York”,
“engine_id”: “200”,
“region_id”: “0”,
“added”: “2018-08-28 12:25:52”,
“is_completed”: “1”
}
]
}