General Data
General Data API provides endpoints to retrieve system-wide data used for project setup and keyword tracking, including search engines, languages, regions, and keyword search volumes.
List search engines
GET https://api4.seranking.com/system/search-engines
Returns a list of available search engines along with their regions, which can be added to projects for position tracking.
Request parameters
No parameters.
Request example
GET https://api4.seranking.com/system/search-enginesResponse parameters
If successful, the server returns the 200 HTTP status code and an array of search engines.
| Parameter | Type | Description |
|---|---|---|
| id | String | Unique search engine ID. |
| name | String | Search engine name. |
| regionid | String | Associated region ID. |
Response example
[
{
"id": "200",
"name": "Google USA",
"regionid": "182"
},
{
"id": "201",
"name": "Google Andorra",
"regionid": "4"
},
{
"id": "202",
"name": "Google United Arab Emirates",
"regionid": "178"
},
...
]List languages for Google
GET https://api4.seranking.com/system/google-langs
Returns a complete list of supported languages for the Google search engine.
Request parameters
No parameters.
Request example
GET https://api4.seranking.com/system/google-langsResponse parameters
If successful, the server returns the 200 HTTP status code and an array of language codes and names.
| Parameter | Type | Description |
|---|---|---|
| lang_code | String | Language code (ISO 639-1). |
| name | String | Language name. |
Response example
[
{
"lang_code": "de",
"name": "Deutsch"
},
{
"lang_code": "en",
"name": "English"
},
{
"lang_code": "es",
"name": "Español"
}
]List regions to get search volume
GET https://api4.seranking.com/system/volume-regions
Returns all regions where SE Ranking can run keyword search volume checks.
Request parameters
No parameters.
Request example
GET https://api4.seranking.com/system/volume-regionsResponse parameters
If successful, the server returns the 200 HTTP status code and an array of regions.
| Parameter | Type | Description |
|---|---|---|
| id | String | Unique region ID. |
| name | String | Region name. |
Response example
[
{
"id": "180",
"name": "United Kingdom"
},
{
"id": "182",
"name": "USA"
},
...
]Get keyword search volume
GET https://api4.seranking.com/system/volume?regionid={region_id}&keyword[]={keyword}
Returns the search volume data for a list of keywords in a specific region.
Request parameters
| Parameter | Required | Description |
|---|---|---|
| regionid | Yes | Region ID (refer to /system/volume-regions to retrieve available regions). |
| keyword[] | Yes | Array of keywords (10 max). Cyrillic keywords must be URL-encoded, e.g., %D0%BA%D0%BB%D1%8E%D1%87. |
Request example
GET https://api4.seranking.com/system/volume?regionid=12&keyword[]=%D0%BA%D0%BB%D1%8E%D1%87Response parameters
If successful, the server returns the 200 HTTP status code and an object mapping keywords to their search volumes. Returns HTTP 400 if regionid or keyword is missing, or if regionid is invalid. Returns HTTP 404 if no data is available (for more information, see Error handling).
| Parameter | Type | Description |
|---|---|---|
| {keyword} | String | Search volume for the keyword. |
Response example
{
"key1": "1000",
"key2": "10000",
...,
"keyN": "100000"
}