REST API
API видимости в ИИ и отслеживания позиций для вашей системы отчётности
Передавайте данные о видимости, промптах, ответах, цитированиях и конкурентах из Geoptie в BigQuery, Looker Studio, клиентские дашборды или собственный продукт. Один bearer-ключ, JSON через HTTPS и никакой месячной квоты на запросы.
ChatGPT
Claude
Perplexity
Gemini
AI Overviews- AI Mode
Copilot
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"{
"data": [
{
"id": "3f2a6c1e-0b7d-4e59-9a41-2c8d5e7f9b10",
"name": "Example Brand",
"domain": "example.com",
"engines": ["chatgpt", "claude", "perplexity", "gemini"],
"country": "US"
}
],
"has_more": false,
"next_cursor": null
}v1
стабильный REST API
7
ИИ-движков в покрытии
120/мин
запросов, без месячного лимита
$99
в месяц, тариф Профессиональный
Нам доверяют маркетинговые команды и агентства
Что такое API видимости в ИИ?
API видимости в ИИ показывает, как ИИ-движки, такие как ChatGPT, Claude, Perplexity, Gemini и ИИ-ответы Google, упоминают и цитируют бренд, в виде данных, которые могут использовать ваши собственные системы. Он также работает как API трекера позиций в ИИ: видимость и позиция по каждому отслеживаемому промпту, в каждом движке, каждый день.
REST API Geoptie отдаёт те же метрики, что и панель, поэтому цифры в хранилище данных, BI-дашборде, клиентском отчёте или оповещении в Slack совпадают с тем, что видит ваша команда.
Первый запрос меньше чем за минуту
Создайте ключ в панели и передавайте его как bearer-токен. GET /v1/brands подтверждает, что ключ работает, и возвращает идентификаторы брендов, которые используют все остальные эндпоинты.
Настройка в три шага
- 1
Создайте ключ
В панели, в разделе API-ключей, для всего рабочего пространства или для выбранных брендов.
- 2
Вызовите GET /v1/brands
Запрос подтверждает, что ключ работает, и возвращает идентификаторы брендов, которые используют все остальные эндпоинты.
- 3
Получите нужные данные
Видимость, промпты, ответы, цитирования и конкуренты по бренду и движку.
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"import os, requests
r = requests.get(
"https://api.geoptie.com/v1/brands",
headers={"Authorization": f"Bearer {os.environ['GEOPTIE_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const r = await fetch("https://api.geoptie.com/v1/brands", {
headers: { Authorization: `Bearer ${process.env.GEOPTIE_API_KEY}` },
});
if (!r.ok) throw new Error(`${r.status} ${await r.text()}`);
console.log(await r.json());Каталог эндпоинтов
Бренды
- GET
/v1/ brands - POST
/v1/ brands - GET
/v1/ brands/ {id} - GET
/v1/ brands/ {id}/ visibility
Промпты и ответы
- GET
/v1/ brands/ {id}/ prompts - POST
/v1/ brands/ {id}/ prompts - GET
/v1/ prompts/ {id}/ responses - GET
/v1/ prompts/ {id}/ mentions
Цитирования
- GET
/v1/ brands/ {id}/ citations - GET
/v1/ brands/ {id}/ citations/ urls - GET
/v1/ brands/ {id}/ citations/ domains - GET
/v1/ brands/ {id}/ citations/ trends
Конкуренты
- GET
/v1/ brands/ {id}/ competitors - GET
/v1/ brands/ {id}/ competitors/ trends - POST
/v1/ brands/ {id}/ tracked-competitors - POST
/v1/ brands/ {id}/ ignored-competitors
Рекомендации и аудиты
- GET
/v1/ brands/ {id}/ recommendations - POST
/v1/ brands/ {id}/ recommendations/ generate - POST
/v1/ audit-reports - GET
/v1/ audit-reports/ {id}
Контент
- POST
/v1/ brands/ {id}/ generations - POST
/v1/ brands/ {id}/ generations/ {generationId}/ draft - POST
/v1/ brands/ {id}/ optimizations - GET
/v1/ brands/ {id}/ topics
Всего 48 операций, включая обновление и удаление. Полный справочник находится в документации API.
Создан для рабочей отчётности
API возвращает те же цифры, что показывает панель, в формате, который сразу ложится в хранилище данных или клиентский отчёт.
Те же цифры, что и в панели
Заранее рассчитанные видимость, позиция и доля голоса, а не сырые строки для сборки, поэтому клиентский отчёт совпадает с тем, что видит ваша команда.
Чтение и запись
Отслеживайте промпты, управляйте темами и конкурентами, работайте с очередью рекомендаций, запускайте аудиты и генерируйте контент через тот же API.
Ключи для рабочего пространства и отдельных брендов
Выдайте клиенту, дашборду или внутренней команде ключ с доступом только к их бренду. Отзыв ключа вступает в силу в течение минуты.
Размеренные, предсказуемые задачи
Курсорная пагинация, даты в ISO 8601 и заголовки rate limit в каждом ответе, чтобы регулярная задача сама регулировала темп и не получала 429.
Понятные ошибки
Стандартные коды статуса HTTP со стабильным кодом ошибки и X-Request-Id в каждом ответе, чтобы поддержка могла отследить запрос.
Стабильное версионирование
v1 стабильна. Новые поля добавляются без уведомления, а несовместимые изменения выходят в /v2 с уведомлением за 90 дней.
Что команды создают с его помощью
Клиентские дашборды
Агентства передают данные о видимости в ИИ каждого клиента в Looker Studio или собственный портал, используя для каждого клиента отдельный ключ с доступом к его бренду.
Синхронизация с хранилищем
Ночная задача копирует данные о видимости, цитированиях и конкурентах в BigQuery или Snowflake рядом с данными SEO и аналитики.
Оповещения
Регулярная проверка отправляет сообщение в Slack или на email, когда приоритетный промпт проседает в каком-либо движке.
ИИ-ассистенты
Тот же ключ работает с MCP-сервером Geoptie для Claude Code, Cursor и Codex.
Входит в тарифы Профессиональный и Корпоративный
Профессиональный
$99/мес
- 10 брендов и 100 промптов
- REST API и MCP-сервер
- Отчёты под вашим брендом
- Неограниченное число участников команды
Корпоративный
$399/мес
- Неограниченное число брендов и 400 промптов
- REST API и MCP-сервер
- Отчёты под вашим брендом
- Неограниченное число участников команды
Вопросы об API видимости в ИИ
Какие данные возвращает API Geoptie?
Какие тарифы включают доступ к API?
Как работает аутентификация?
Какие лимиты запросов у API?
Можно ли получать данные о конкурентах через API?
Можно ли дать клиенту доступ к API только для его бренда?
Какие ИИ-движки охватывает API?
Есть ли также MCP-сервер?
Поставьте видимость в ИИ рядом с остальными данными
Начните с тарифа Профессиональный, создайте ключ, и первый запрос вернёт ваши бренды меньше чем за минуту.
Начать