SerpWatch
Меню

Структура сайта

Метод API SerpWatch: структура сайта — дерево разделов по адресам, глубина клика, ошибки и трафик разделов.

GET/api/v1/projects/{id}/structure

Строит дерево разделов по последнему завершённому аудиту: раздел → подраздел (до 3 уровней, до 50 детей на узел). Для каждого узла — страницы, ошибки аудита, средняя глубина клика, доля noindex и редиректов, запросы в топ-10 и клики за 30 дней. Плюс распределение страниц по глубине и важные страницы глубже 3 кликов.

Параметры

ПараметрГдеЧто значит
idв путиid проекта

Ответ

ПолеЧто значит
auditid, finished_at, pages, limited — аудит, по которому построено дерево, или null
depthстраниц с кодом 200 по глубине клика: 1, 2, 3, 4+
warn_deeptrue — важные страницы далеко от главной или четверть сайта глубже 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 запросов в минуту — в разделе ошибки и лимиты.

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

  • Сводка по разделам в своём дашборде
  • Контроль глубины важных страниц после смены меню