Список проектов

Метод API SerpWatch: проекты аккаунта и гостевые проекты с регионами и устройствами.

GET/api/v1/projects

Возвращает все проекты, доступные токену: свои и те, куда вас пригласили. С этого метода обычно начинают: из ответа берут id проекта и id региона для остальных методов.

Ответ

Поле	Что значит
`id`	id проекта
`name`	название
`domain`	домен сайта
`keywords`	сколько запросов
`regions[]`	регионы: id, lr (код региона Яндекса), name, device — ALL, DESKTOP или MOBILE_AND_TABLET

[
  {
    "id": 12,
    "name": "Автосервис",
    "domain": "site.ru",
    "keywords": 148,
    "regions": [
      {
        "id": 31,
        "lr": 22,
        "name": "Калининград",
        "device": "ALL"
      }
    ]
  }
]

Примеры

curl

curl -H "Authorization: Bearer sw_ваш_токен" \
  "https://serpwatch.ru/api/v1/projects"

Python

import requests

r = requests.get("https://serpwatch.ru/api/v1/projects",
                 headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())

Ошибки

Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.

Для чего пригодится

Найти id проекта и региона для выгрузки позиций
Построить список сайтов в своём дашборде