Структура сайта
Метод API SerpWatch: структура сайта — дерево разделов по адресам, глубина клика, ошибки и трафик разделов.
GET/api/v1/projects/{id}/structure
Строит дерево разделов по последнему завершённому аудиту: раздел → подраздел (до 3 уровней, до 50 детей на узел). Для каждого узла — страницы, ошибки аудита, средняя глубина клика, доля noindex и редиректов, запросы в топ-10 и клики за 30 дней. Плюс распределение страниц по глубине и важные страницы глубже 3 кликов.
Параметры
| Параметр | Где | Что значит |
|---|---|---|
id | в пути | id проекта |
Ответ
| Поле | Что значит |
|---|---|
audit | id, finished_at, pages, limited — аудит, по которому построено дерево, или null |
depth | страниц с кодом 200 по глубине клика: 1, 2, 3, 4+ |
warn_deep | true — важные страницы далеко от главной или четверть сайта глубже 3 кликов |
tree | корень: name, prefix, level, pages, errors, warnings, avg_depth, noindex_pct, redirect_pct, top10, clicks, more (сколько детей не показано), children[] того же вида |
deep_important[] | url, depth, top10, clicks — важные страницы глубже 3 кликов |
{
"audit": {
"id": 41,
"finished_at": "2026-10-12T05:02:11",
"pages": 1240,
"limited": false
},
"depth": {
"1": 18,
"2": 210,
"3": 640,
"4+": 352
},
"warn_deep": true,
"tree": {
"name": "/",
"prefix": "/",
"level": 0,
"pages": 1240,
"errors": 37,
"warnings": 210,
"avg_depth": 2.9,
"noindex_pct": 4,
"redirect_pct": 2,
"top10": 58,
"clicks": 4210,
"more": 0,
"children": [
{
"name": "catalog",
"prefix": "/catalog/",
"level": 1,
"pages": 980,
"errors": 30,
"warnings": 150,
"avg_depth": 3.2,
"noindex_pct": 5,
"redirect_pct": 1,
"top10": 41,
"clicks": 3100,
"more": 0,
"children": []
}
]
},
"deep_important": [
{
"url": "https://site.ru/catalog/shiny/zimnie/",
"depth": 5,
"top10": 3,
"clicks": 120
}
]
}
Примеры
curl
curl -H "Authorization: Bearer sw_ваш_токен" \ "https://serpwatch.ru/api/v1/projects/12/structure"
Python
import requests
r = requests.get("https://serpwatch.ru/api/v1/projects/12/structure",
headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())
Ошибки
Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.
Для чего пригодится
- Сводка по разделам в своём дашборде
- Контроль глубины важных страниц после смены меню