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": { ... }
}
]Поля объекта страницы
| Поле | Тип | Описание |
|---|---|---|
url | string | URL страницы |
meta_tags.title | string | Содержимое <title> |
meta_tags.title_length | integer | Длина тайтла в символах |
meta_tags.description | string | Мета-описание |
meta_tags.description_length | integer | Длина мета-описания |
content.h1_heading | string | Текст первого <h1> |
content.heading_structure_raw | string | Все заголовки H1–H6 через ; |
metrics.char_count_no_spaces | integer | Количество символов без пробелов |
metrics.uniqueness_percentage | float | Уникальность текста (%) |
HTTP-статусы
| Код | Значение |
|---|---|
200 | Успех |
404 | Задача не найдена или структура ещё не готова |
401 | Нет авторизации |
TIP
Структура страниц включается автоматически в Python SDK (result["page_structure"]). Этот эндпоинт нужен при прямом использовании REST API.