Obtaining the list of project regions and their status

The RtApiSearchEngineProcedure.getProjectRegions method returns the list of project regions and their status.

Use case: Get a list of regions for each project in Rank Tracker with their status to check how your site's rankings are tracked in different regions and ensure that your analysis is accurate across all target markets.
1. Send a request using the RtApiSearchEngineProcedure.getProjectRegions method with the project ID.
2. Get a list of regions with Rank Tracker statuses for each of them.
3. Analyze the data and decide on further actions (update regions, add new ones, update positions).

General request parameters and instructions for using Serpstat API

Search databases available

Request parameters
Parameter	Description	Type	Optional	Default value	Value options
id	A request id: the response contains the same id.	int / string	no		Any text or number value, for example: 1, test
method	API method name	string	no		RtApiSearchEngineProcedure.getProjectRegions
params	The object with parameters {...}, it lists all the following parameters and arrays [...]		no
projectId	Project ID	int	no		Number value

Response parameters
Parameter	Description
id	Response id corresponds the request id
result	Contains the answer
projectId	Project ID
regions	Array with regions
id	Region ID
active	Region status: * true — active; * false — deactivated
serpType	SERP type: * organic * paid (PPC)
deviceType	Device type: * desktop * mobile
searchEngine	Search engine type: * Google
country	Search results country
region	Search results region
city	Search results city
langCode	Language code

Credits for this method are not deducted.

Example

Request data:

{
    "id": 1,
    "method": "RtApiSearchEngineProcedure.getProjectRegions",
    "params": {
        "projectId": 853932
    }
}

Response data:

{
    "id": "1",
    "result": {
        "projectId": 853932,
        "regions": [
            {
                "id": 293402,
                "active": true,
                "serpType": "organic",
                "deviceType": "desktop",
                "searchEngine": "google",
                "country": "United States (USA)",
                "region": "",
                "city": "",
                "langCode": "en"
            },
            {
                "id": 295014,
                "active": false,
                "serpType": "organic",
                "deviceType": "desktop",
                "searchEngine": "google",
                "country": "Ukraine",
                "region": "",
                "city": "",
                "langCode": "en"
            }
        ],
        "spent_limits": 0
    }
}