Skip to content

GET /api/v1/report/structure/

Возвращает структуру страниц (мета-теги, заголовки, метрики контента) для вашей страницы и всех конкурентов.

Запрос

http
GET /api/v1/report/structure/550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer YOUR_KEY

Ответ

Массив объектов — первый элемент всегда ваша страница, далее конкуренты.

json
[
  {
    "url": "https://example.com/product",
    "meta_tags": {
      "title": "Купить матрас — Пример Магазин",
      "title_length": 30,
      "description": "Ортопедические матрасы с бесплатной доставкой.",
      "description_length": 47
    },
    "content": {
      "h1_heading": "Ортопедические матрасы",
      "heading_structure_raw": "H1: Ортопедические матрасы; H2: Характеристики; H2: Доставка; H3: Условия"
    },
    "metrics": {
      "char_count_no_spaces": 4821,
      "uniqueness_percentage": 91.3
    }
  },
  {
    "url": "https://comp1.com/mattress",
    "meta_tags": { ... },
    "content": { ... },
    "metrics": { ... }
  }
]

Поля объекта страницы

ПолеТипОписание
urlstringURL страницы
meta_tags.titlestringСодержимое <title>
meta_tags.title_lengthintegerДлина тайтла в символах
meta_tags.descriptionstringМета-описание
meta_tags.description_lengthintegerДлина мета-описания
content.h1_headingstringТекст первого <h1>
content.heading_structure_rawstringВсе заголовки H1–H6 через ;
metrics.char_count_no_spacesintegerКоличество символов без пробелов
metrics.uniqueness_percentagefloatУникальность текста (%)

HTTP-статусы

КодЗначение
200Успех
404Задача не найдена или структура ещё не готова
401Нет авторизации

TIP

Структура страниц включается автоматически в Python SDK (result["page_structure"]). Этот эндпоинт нужен при прямом использовании REST API.