Инструменты · key

geopanel Анализ сайта в ответах нейросетей

Показывает, как сайт присутствует в ответах нейросетей — Алисы, Google AI Overview, ChatGPT, Perplexity и других: на какие промпты его страницы попадают в источники, как менялось число упоминаний по месяцам и какие сайты цитируются рядом. Данные берутся из базы ответов нейросетей Пиксель Тулс за последние 12 месяцев. Метод асинхронный: постановка возвращает report_id. То же в интерфейсе — анализ брендов и сайтов в нейросетях.

Режим
асинхронный: report_id
Стоимость
100 лимитов за задачу; возвращаются, если по сайту ничего не нашлось или проверка упала
Тело
форма или JSON

Постановка задачи

POST /api/geopanel

Параметры — в теле формы или JSON (Content-Type: application/json), ключ — в query.

Параметры query и тело формы

  • site string обязательный
    Домен или URL сайта.
  • include_subdomains bool
    Учитывать поддомены. В форме включается любым непустым значением, в том числе строкой false — чтобы не учитывать, не передавайте параметр или передайте 0.
    По умолчанию false
  • models array
    Нейросети — массив models[]. Без параметра — все доступные. Список меняется; на момент написания: yandex-alisa, google-ai-overview, openai, perplexity, alice-ai, deepseek, claude, grok, qwen, gemini. Неизвестное имя — ошибка с полным списком допустимых.

Ответ

  • report_id int
    ID задачи для получения результата.

Получение результата

GET /api/geopanel

Пока задача выполняется, приходит {"error": "In progress", "code": 50, "progress": 50}.

Параметры query

  • report_id int обязательный
    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_found int
    Сколько URL сайта найдено в источниках.
  • response.tables_count, tables_total_count object
    Строк в таблицах prompts, sources, competitors: в ответе и всего.
  • response.csv_files array
    Ссылки на CSV-выгрузки отчёта, если есть.
  • time string
    Время готовности, Unix timestamp.
  • cost int
    Стоимость задачи в лимитах.

Ошибки

КодСообщениеКогда
-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 и лимиты вернутся.

Обратная связь и помощь
Если у вас есть идеи, как улучшить данный инструмент или остались вопросы по работе с ним, напишите в нашу службу поддержки, мы обязательно вам поможем.