geopanel Анализ сайта в ответах нейросетей
Показывает, как сайт присутствует в ответах нейросетей — Алисы, Google AI Overview, ChatGPT, Perplexity и других: на какие промпты его страницы попадают в источники, как менялось число упоминаний по месяцам и какие сайты цитируются рядом. Данные берутся из базы ответов нейросетей Пиксель Тулс за последние 12 месяцев. Метод асинхронный: постановка возвращает report_id. То же в интерфейсе — анализ брендов и сайтов в нейросетях.
- Режим
- асинхронный:
report_id - Стоимость
- 100 лимитов за задачу; возвращаются, если по сайту ничего не нашлось или проверка упала
- Тело
- форма или JSON
Постановка задачи
/api/geopanel
Параметры — в теле формы или JSON (Content-Type: application/json), ключ — в query.
Параметры query и тело формы
-
sitestring обязательныйДомен или URL сайта. -
include_subdomainsboolУчитывать поддомены. В форме включается любым непустым значением, в том числе строкойfalse— чтобы не учитывать, не передавайте параметр или передайте0. -
modelsarrayНейросети — массивmodels[]. Без параметра — все доступные. Список меняется; на момент написания:yandex-alisa,google-ai-overview,openai,perplexity,alice-ai,deepseek,claude,grok,qwen,gemini. Неизвестное имя — ошибка с полным списком допустимых.
Ответ
-
report_idintID задачи для получения результата.
Получение результата
/api/geopanel
Пока задача выполняется, приходит {"error": "In progress", "code": 50, "progress": 50}.
Параметры query
-
report_idint обязательныйID задачи из ответа на постановку.
Ответ
-
response.prompts[]arrayПромпты, в ответах на которые встречается сайт:prompt{id,prompt},neurals[]— по каждой нейросети ответ (ai_response), позиция упоминания и страницы сайта в источниках,last_check_date. Таблица «Промпты» в интерфейсе. -
response.mentions_chart[]arrayДинамика упоминаний: серия «Все» и по серии на нейросеть, точки{x: "ММ.ГГГГ", y: число}. -
response.sources[]arrayСтраницы сайта в источниках:url,domain,frequency— сколько раз процитирована,prompts[]. Таблица «Источники». -
response.competitors[]arrayСайты-конкуренты из тех же ответов:competitor,total_mentions_count,prompts[]. Таблица «Конкуренты». -
response.urls_foundintСколько URL сайта найдено в источниках. -
response.tables_count, tables_total_countobjectСтрок в таблицахprompts,sources,competitors: в ответе и всего. -
response.csv_filesarrayСсылки на CSV-выгрузки отчёта, если есть. -
timestringВремя готовности, Unix timestamp. -
costintСтоимость задачи в лимитах.
Ошибки
| Код | Сообщение | Когда |
|---|---|---|
-50 |
site |
Не передан site: {"error": "site", "details": "Not set", "code": "-50"}. |
-100 |
tools errors |
Ошибки постановки — список в details: недопустимая нейросеть в models, больше 5 задач одновременно. С errorType: TASK_START_FAIL — задачу не удалось поставить в очередь. |
-100 |
По сайту «…» ничего не найдено… |
При получении результата: сайт не встречался в источниках (error_type: not_found) или проверка завершилась ошибкой (error_type: error). Лимиты возвращаются. |
-51 |
No requests data |
Задача поставлена не методом POST. |
-68, -80…-83 |
Not enough … limits |
Не хватает лимитов; в ответе available и need. |
50 |
In progress |
Задача ещё выполняется; progress — процент готовности. |
-4 |
Access denied |
report_id чужой или от другого инструмента. |
-104…-107, -125 |
Processing error / Limits run out / … |
Задача завершилась ошибкой — см. асинхронные задачи. |
-1, -2 |
Access denied |
Ключ не передан (HTTP 404) или не найден (HTTP 403). |
Через API доступен только анализ сайта. Анализ бренда по названию, который есть в интерфейсе инструмента, методом не поддерживается.
Проверка идёт по уже собранной базе ответов нейросетей, а не опросом нейросетей в момент запроса, поэтому небольшой или новый сайт может не найтись — тогда придёт ошибка not_found и лимиты вернутся.