Назад к блогу

Шпиониро API: как интегрировать мониторинг в свою систему

Команда Шпиониро29 июня 2026 г.14 мин чтения
Шпиониро API: как интегрировать мониторинг в свою систему

Введение

Вы уже поняли, что GEO-оптимизация критична для вашего бизнеса. Вы знаете, что нужно мониторить упоминания вашего бренда в нейросетях, анализировать конкурентов, отслеживать тренды. Но раньше вы делали это вручную, через дашборд Шпиониро.

Теперь вы готовы к следующему уровню: интеграция.

Представьте себе:

  • Вы просыпаетесь, и в вашем Slack появляется сообщение: "Ваша видимость в ChatGPT выросла на 25% за ночь"
  • Ваша CRM-система автоматически обновляется с последними данными о вашей видимости в AI
  • Ваш кастомный дашборд показывает не только вашу видимость, но и данные о 5 конкурентах в реальном времени
  • Вы запускаете автоматизированный еженедельный отчет, который отправляется своим акционерам без вашего участия

Это не фантастика. Это реальность, когда вы используете API. Для начала, вы можете ознакомиться с основными инструментами мониторинга конкурентов в нейросетях, чтобы понять, как данные используются на практике.

В этой статье мы разберем, как использовать API Шпиониро для интеграции мониторинга в вашу собственную систему. Мы покажем вам, как работает API, какие данные вы можете получить, как его использовать с Python и JavaScript, какие у вас есть опции для вебхуков и кастомных дашбордов. Если вам нужна интеграция с корпоративными системами, см. решение для больших организаций.

Если вы разработчик, это для вас. Если вы менеджер, который работает с разработчиком, это даст вам понимание того, что возможно.

Что такое Шпиониро API и зачем она нужна

API как расширение возможностей

Шпиониро дашборд — это мощный инструмент для анализа видимости в AI. Но он рассчитан на определенные use cases. Если вы хотите сделать что-то более кастомное — например, интегрировать данные Шпиониро с вашей CRM, или создать свой кастомный дашборд, или автоматизировать отчеты — вам нужен доступ к API.

API (Application Programming Interface) — это набор правил, которые позволяют программам общаться между собой. Шпиониро API позволяет вашей системе напрямую получать данные о видимости в нейросетях, упоминаниях, трендах и конкурентов.

Основные возможности API

С помощью API Шпиониро вы можете:

  1. Получать данные о видимости: Visibility Index, Frequency Score, тренды за различные периоды
  2. Анализировать упоминания: когда вас упоминают, в каком контексте, какие источники цитирует AI
  3. Мониторить конкурентов: все те же данные для ваших конкурентов
  4. Получать тренды: какие темы растут в популярности в вашей нише
  5. Настраивать вебхуки: получать уведомления в реальном времени при изменении ключевых метрик
  6. Экспортировать данные: для интеграции с другими системами

Use cases для API

Use case 1: Интеграция с CRM

Ваша CRM (Salesforce, HubSpot, Pipedrive) сейчас содержит информацию о клиентах, сделках, взаимодействиях. Но она не знает о вашей видимости в AI. С помощью API вы можете добавить поле "Visibility Score" для каждого клиента — это показывает, насколько видна ваша компания в глазах этого клиента при его поиске в AI.

Результат: ваша CRM становится более информативной, ваша продажа может видеть контекст.

Use case 2: Кастомный дашборд

Вам нужен дашборд, который показывает не только вашу видимость, но и данные 5 конкурентов, и ваши SEO позиции в Google, и социальные медиа метрики. С помощью API вы можете создать кастомный дашборд, который объединяет все эти данные в одном месте.

Результат: единый источник истины для вашего маркетингового командира.

Use case 3: Автоматизированные отчеты

Вы хотите отправлять еженедельный отчет акционерам про видимость компании. С помощью API вы можете автоматизировать этот процесс — отчет генерируется сам, наполняется данными из Шпиониро, и отправляется по расписанию.

Результат: экономия времени, всегда актуальные данные, профессиональный вид.

Use case 4: Интеграция с Slack

Вы хотите, чтобы ваша команда знала о важных изменениях в видимости компании. С помощью вебхуков API вы можете настроить уведомления в Slack: "Ваша видимость в YandexGPT выросла на 30%" или "Конкурент вдруг стал часто упоминаться по новой теме".

Результат: команда всегда в курсе, быстрая реакция на изменения.

Use case 5: Исследовательские проекты

Вы исследуете, как GEO работает в разных индустриях. С помощью API вы можете сделать большой анализ, собрать данные по сотням компаний и темам, построить модель, предсказать тренды.

Результат: данные, которые дают вам конкурентное преимущество.

Перед началом: аутентификация и базовые концепции

Как получить доступ к API

Чтобы использовать Шпиониро API, вам нужен:

  1. Аккаунт на Шпиониро с активной подпиской (минимум Pro)
  2. API ключ — уникальный идентификатор, который вы генерируете в настройках профиля
  3. Базовые знания про HTTP запросы, JSON, и работу с API

Процесс получения API ключа:

  1. Логин в Шпиониро
  2. Настройки профиля → API & Integrations
  3. "Generate new API key"
  4. Копируете ключ и сохраняете в безопасном месте

Никогда не делитесь API ключом! Это как пароль, но с большим доступом.

Базовая структура API запроса

Все запросы к Шпиониро API используют REST архитектуру и JSON формат. Базовый запрос выглядит так:

GET /api/v1/brands/{brandId}/visibility
Authorization: Bearer YOUR_API_KEY

В ответ вы получаете JSON:

{
  "brandId": "123456",
  "visibilityIndex": 7.5,
  "frequencyScore": 8.2,
  "mentionsTrend": "up",
  "periodDays": 30,
  "timestamp": "2026-07-03T12:00:00Z"
}

Основные понятия в API

Brand ID: уникальный идентификатор бренда в Шпиониро. Когда вы добавляете бренд в отслеживание, вам дается его ID.

Visibility Index: основная метрика (0-10), показывающая, насколько видна ваша компания в AI.

Frequency Score: как часто ваша компания упоминается в ответах AI.

Period: временной интервал для анализа (7 дней, 30 дней, 90 дней и т.д.).

AI Model: какая AI модель отслеживается (ChatGPT, YandexGPT, Claude и т.д.).

Основные endpoints API Шпиониро

Endpoint 1: Get Visibility Score

GET /api/v1/brands/{brandId}/visibility?period=30&aiModel=chatgpt
Authorization: Bearer YOUR_API_KEY

Что это возвращает:

{
  "brandId": "123456",
  "brand": "Шпиониро",
  "visibilityIndex": 7.8,
  "frequencyScore": 8.5,
  "mentionCount": 147,
  "trendDirection": "up",
  "trendPercentage": 15.3,
  "aiModel": "chatgpt",
  "period": 30,
  "timestamp": "2026-07-03T12:00:00Z"
}

Когда использовать: если вам нужна основная метрика видимости для вашего дашборда или отчета.

Пример use case: вы добавляете эту метрику в ежемесячный отчет для руководства.

Endpoint 2: Get Mentions

GET /api/v1/brands/{brandId}/mentions?period=30&limit=50
Authorization: Bearer YOUR_API_KEY

Что это возвращает:

{
  "mentions": [
    {
      "mentionId": "m123456",
      "brand": "Шпиониро",
      "aiModel": "chatgpt",
      "query": "какой инструмент для мониторинга упоминаний лучше",
      "context": "Шпиониро — это сервис мониторинга упоминаний бренда в нейросетях...",
      "sentiment": "positive",
      "sourceUrl": "https://example.com/article",
      "timestamp": "2026-03-28T15:30:00Z"
    },
    // ... ещё 49 упоминаний
  ],
  "totalCount": 412,
  "period": 30
}

Когда использовать: если вам нужны детали о конкретных упоминаниях, контексте, источниках.

Пример use case: вы создаете отчет, который показывает не только цифры, но и примеры — что именно говорит AI о вас.

Endpoint 3: Get Competitor Data

GET /api/v1/brands/{brandId}/competitors?limit=5
Authorization: Bearer YOUR_API_KEY

Что это возвращает:

{
  "brand": "Шпиониро",
  "competitors": [
    {
      "competitorId": "comp001",
      "competitorName": "Competitor A",
      "visibilityIndex": 6.2,
      "frequencyScore": 7.1,
      "mentionCount": 89,
      "comparisonToYou": -1.6
    },
    {
      "competitorId": "comp002",
      "competitorName": "Competitor B",
      "visibilityIndex": 5.8,
      "frequencyScore": 6.5,
      "mentionCount": 72,
      "comparisonToYou": -2.0
    },
    // ... ещё конкуренты
  ]
}

Когда использовать: если вам нужны данные по конкурентам в одном запросе.

Пример use case: вы строите матрицу конкурентного анализа на вашем дашборде.

GET /api/v1/brands/{brandId}/trends?period=90&topN=20
Authorization: Bearer YOUR_API_KEY

Что это возвращает:

{
  "brand": "Шпиониро",
  "trends": [
    {
      "keyword": "мониторинг упоминаний",
      "searchVolume": 450,
      "mentions": 87,
      "trend": "up",
      "trendPercentage": 22.5
    },
    {
      "keyword": "AI видимость",
      "searchVolume": 320,
      "mentions": 65,
      "trend": "up",
      "trendPercentage": 18.3
    },
    {
      "keyword": "GEO-оптимизация",
      "searchVolume": 210,
      "mentions": 42,
      "trend": "up",
      "trendPercentage": 15.0
    },
    // ... ещё тренды
  ]
}

Когда использовать: если вам нужно понять, какие темы растут в популярности в вашей нише.

Пример use case: вы используете эти данные для планирования контента на следующий квартал.

Endpoint 5: Get Keywords Performance

GET /api/v1/brands/{brandId}/keywords?keywords=["мониторинг","AI","бренд"]
Authorization: Bearer YOUR_API_KEY

Что это возвращает:

{
  "brand": "Шпиониро",
  "keywordPerformance": [
    {
      "keyword": "мониторинг",
      "visibilityScore": 8.5,
      "frequency": 45,
      "sentiment": 0.78,
      "topContexts": ["инструменты для мониторинга", "как выбрать инструмент"]
    },
    {
      "keyword": "AI",
      "visibilityScore": 6.2,
      "frequency": 23,
      "sentiment": 0.65,
      "topContexts": ["AI для бизнеса", "новые AI инструменты"]
    },
    {
      "keyword": "бренд",
      "visibilityScore": 7.1,
      "frequency": 34,
      "sentiment": 0.72,
      "topContexts": ["защита бренда", "репутация бренда"]
    }
  ]
}

Когда использовать: если вам нужно отследить, как вы видимы по конкретным ключевым словам.

Пример use case: вы хотите видеть, по каким ключевым словам вы сильны, а по каким нужна доработка контента.

Примеры интеграции: Python и JavaScript

Пример 1: Python — получение видимости и отправка в Slack

import requests
import json
from datetime import datetime

# Конфигурация
SPIONIRO_API_KEY = "your_api_key_here"
SPIONIRO_BRAND_ID = "123456"
SLACK_WEBHOOK_URL = "https://hooks.slack.com/services/YOUR/WEBHOOK/URL"

def get_visibility_from_spioniro():
    """Получает данные видимости из Шпиониро API"""
    url = f"https://api.spioniro.ru/v1/brands/{SPIONIRO_BRAND_ID}/visibility"
    headers = {
        "Authorization": f"Bearer {SPIONIRO_API_KEY}",
        "Content-Type": "application/json"
    }
    params = {
        "period": 30,
        "aiModel": "chatgpt"
    }

    response = requests.get(url, headers=headers, params=params)

    if response.status_code == 200:
        return response.json()
    else:
        raise Exception(f"API ошибка: {response.status_code}")

def send_to_slack(visibility_data):
    """Отправляет данные видимости в Slack"""
    message = {
        "text": "Еженедельный отчет видимости Шпиониро",
        "attachments": [
            {
                "color": "good" if visibility_data['trendDirection'] == 'up' else 'danger',
                "fields": [
                    {
                        "title": "Visibility Index",
                        "value": f"{visibility_data['visibilityIndex']:.1f} / 10",
                        "short": True
                    },
                    {
                        "title": "Frequency Score",
                        "value": f"{visibility_data['frequencyScore']:.1f}",
                        "short": True
                    },
                    {
                        "title": "Упоминаний в ChatGPT",
                        "value": f"{visibility_data['mentionCount']} (за месяц)",
                        "short": True
                    },
                    {
                        "title": "Тренд",
                        "value": f"↑ {visibility_data['trendPercentage']:.1f}%" if visibility_data['trendDirection'] == 'up' else f"↓ {visibility_data['trendPercentage']:.1f}%",
                        "short": True
                    }
                ],
                "footer": f"Обновлено: {visibility_data['timestamp']}"
            }
        ]
    }

    response = requests.post(SLACK_WEBHOOK_URL, json=message)
    return response.status_code == 200

# Основной процесс
if __name__ == "__main__":
    try:
        # Получаем данные
        visibility_data = get_visibility_from_spioniro()
        print("Данные получены успешно:")
        print(json.dumps(visibility_data, indent=2, ensure_ascii=False))

        # Отправляем в Slack
        success = send_to_slack(visibility_data)
        if success:
            print("Сообщение отправлено в Slack!")
        else:
            print("Ошибка при отправке в Slack")

    except Exception as e:
        print(f"Ошибка: {e}")

Как это работает:

  1. Функция get_visibility_from_spioniro() делает запрос к API с вашим ключом
  2. Функция send_to_slack() форматирует данные и отправляет их в Slack webhook
  3. При запуске скрипта вы получаете сообщение в Slack с актуальными данными

Как запустить:

python spioniro_slack_report.py

Как автоматизировать еженедельно (Linux/Mac):

# Добавьте в crontab
0 9 * * 1 /usr/bin/python3 /path/to/spioniro_slack_report.py
# Это запустит скрипт каждый понедельник в 9:00

Пример 2: JavaScript — создание кастомного дашборда

// Конфигурация
const SPIONIRO_API_KEY = 'your_api_key_here';
const SPIONIRO_BRAND_ID = '123456';
const API_BASE_URL = 'https://api.spioniro.ru/v1';

class SpionoroClient {
    constructor(apiKey, brandId) {
        this.apiKey = apiKey;
        this.brandId = brandId;
    }

    // Вспомогательный метод для запросов
    async request(endpoint, params = {}) {
        const url = new URL(`${API_BASE_URL}${endpoint}`);

        // Добавляем параметры
        Object.keys(params).forEach(key =>
            url.searchParams.append(key, params[key])
        );

        const response = await fetch(url, {
            method: 'GET',
            headers: {
                'Authorization': `Bearer ${this.apiKey}`,
                'Content-Type': 'application/json'
            }
        });

        if (!response.ok) {
            throw new Error(`API ошибка: ${response.status}`);
        }

        return await response.json();
    }

    // Получить видимость
    async getVisibility(period = 30, aiModel = 'chatgpt') {
        return this.request(`/brands/${this.brandId}/visibility`, {
            period,
            aiModel
        });
    }

    // Получить конкурентов
    async getCompetitors(limit = 5) {
        return this.request(`/brands/${this.brandId}/competitors`, {
            limit
        });
    }

    // Получить тренды
    async getTrends(period = 90) {
        return this.request(`/brands/${this.brandId}/trends`, {
            period,
            topN: 10
        });
    }
}

// Класс для визуализации дашборда
class SpionoroDashboard {
    constructor(clientId, containerId) {
        this.client = new SpionoroClient(SPIONIRO_API_KEY, clientId);
        this.container = document.getElementById(containerId);
    }

    async render() {
        try {
            // Получаем все данные
            const [visibility, competitors, trends] = await Promise.all([
                this.client.getVisibility(),
                this.client.getCompetitors(),
                this.client.getTrends()
            ]);

            // Строим HTML
            this.container.innerHTML = `
                <div class="dashboard">
                    <h1>Мой GEO Dashboard</h1>

                    <div class="metrics-grid">
                        <div class="metric-card">
                            <div class="metric-label">Visibility Index</div>
                            <div class="metric-value">${visibility.visibilityIndex.toFixed(1)}/10</div>
                            <div class="metric-trend ${visibility.trendDirection}">
                                ${visibility.trendDirection === 'up' ? '↑' : '↓'} ${visibility.trendPercentage.toFixed(1)}%
                            </div>
                        </div>

                        <div class="metric-card">
                            <div class="metric-label">Frequency Score</div>
                            <div class="metric-value">${visibility.frequencyScore.toFixed(1)}</div>
                            <div class="metric-info">${visibility.mentionCount} упоминаний/мес</div>
                        </div>
                    </div>

                    <div class="competitors-section">
                        <h2>Конкуренты</h2>
                        <table class="competitors-table">
                            <thead>
                                <tr>
                                    <th>Компания</th>
                                    <th>Visibility Index</th>
                                    <th>Frequency</th>
                                    <th>Разница с вами</th>
                                </tr>
                            </thead>
                            <tbody>
                                ${competitors.competitors.map(comp => `
                                    <tr>
                                        <td>${comp.competitorName}</td>
                                        <td>${comp.visibilityIndex.toFixed(1)}</td>
                                        <td>${comp.frequencyScore.toFixed(1)}</td>
                                        <td class="${comp.comparisonToYou > 0 ? 'negative' : 'positive'}">
                                            ${comp.comparisonToYou > 0 ? '+' : ''}${comp.comparisonToYou.toFixed(1)}
                                        </td>
                                    </tr>
                                `).join('')}
                            </tbody>
                        </table>
                    </div>

                    <div class="trends-section">
                        <h2>Растущие темы</h2>
                        <ul class="trends-list">
                            ${trends.trends.slice(0, 5).map(trend => `
                                <li>
                                    <strong>${trend.keyword}</strong>
                                    <span class="trend-percentage">↑ ${trend.trendPercentage.toFixed(1)}%</span>
                                    <div class="trend-mentions">${trend.mentions} упоминаний</div>
                                </li>
                            `).join('')}
                        </ul>
                    </div>
                </div>
            `;

        } catch (error) {
            this.container.innerHTML = `<div class="error">Ошибка загрузки данных: ${error.message}</div>`;
        }
    }
}

// Инициализация при загрузке страницы
document.addEventListener('DOMContentLoaded', () => {
    const dashboard = new SpionoroDashboard(SPIONIRO_BRAND_ID, 'dashboard-container');
    dashboard.render();

    // Обновлять каждый час
    setInterval(() => dashboard.render(), 3600000);
});

HTML для дашборда:

<!DOCTYPE html>
<html>
<head>
    <title>Шпиониро Dashboard</title>
    <style>
        .dashboard { font-family: Arial; padding: 20px; }
        .metrics-grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 20px; margin: 20px 0; }
        .metric-card { border: 1px solid #ddd; padding: 20px; border-radius: 8px; }
        .metric-value { font-size: 32px; font-weight: bold; color: #333; }
        .metric-trend.up { color: green; }
        .metric-trend.down { color: red; }
        .competitors-table { width: 100%; border-collapse: collapse; margin: 20px 0; }
        .competitors-table th, .competitors-table td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
        .trends-list { list-style: none; padding: 0; }
        .trends-list li { padding: 10px; border-bottom: 1px solid #eee; }
    </style>
</head>
<body>
    <div id="dashboard-container"></div>
    <script src="spioniro-dashboard.js"></script>
</body>
</html>

Вебхуки: уведомления в реальном времени

Как работают вебхуки

Вебхуки — это способ получать данные в реальном времени без необходимости постоянно спрашивать API. Когда происходит важное событие (ваша видимость выросла на 20%, конкурент опубликовал статью по вашей теме и т.д.), Шпиониро отправляет POST запрос на ваш URL.

Как настроить вебхук

  1. В настройках профиля Шпиониро → Webhooks
  2. "Add webhook"
  3. Укажите URL, на который Шпиониро будет отправлять уведомления
  4. Выберите события: visibility change, mention detected, competitor activity, trend alert и т.д.
  5. Сохраните

Обработка вебхука на сервере

from flask import Flask, request, jsonify
import hmac
import hashlib
import json

app = Flask(__name__)

# Ваш API ключ для проверки подписи
SPIONIRO_API_KEY = "your_api_key_here"

@app.route('/webhook/spioniro', methods=['POST'])
def handle_webhook():
    """Обработчик вебхуков от Шпиониро"""

    # Получаем данные и подпись
    data = request.get_json()
    signature = request.headers.get('X-Spioniro-Signature')

    # Проверяем подпись (важно для безопасности)
    expected_signature = hmac.new(
        SPIONIRO_API_KEY.encode(),
        request.get_data(),
        hashlib.sha256
    ).hexdigest()

    if signature != expected_signature:
        return jsonify({'error': 'Invalid signature'}), 401

    # Обрабатываем событие
    event_type = data.get('event')

    if event_type == 'visibility_change':
        handle_visibility_change(data)
    elif event_type == 'mention_detected':
        handle_mention_detected(data)
    elif event_type == 'competitor_activity':
        handle_competitor_activity(data)
    elif event_type == 'trend_alert':
        handle_trend_alert(data)

    return jsonify({'success': True}), 200

def handle_visibility_change(data):
    """Обработка изменения видимости"""
    visibility_change = data.get('payload', {})
    print(f"Видимость изменилась: {visibility_change}")

    # Можете отправить уведомление в Slack, сохранить в БД и т.д.
    change_percentage = visibility_change.get('changePercentage')
    new_index = visibility_change.get('newVisibilityIndex')

    if change_percentage > 20:
        # Значительное изменение — отправляем в Slack
        send_slack_notification(f"Видимость выросла на {change_percentage}%! Новый индекс: {new_index}")

def handle_mention_detected(data):
    """Обработка нового упоминания"""
    mention = data.get('payload', {})
    print(f"Новое упоминание: {mention}")

    # Сохраняем в БД, отправляем аналитику и т.д.

def handle_competitor_activity(data):
    """Обработка активности конкурента"""
    activity = data.get('payload', {})
    print(f"Активность конкурента: {activity}")

def handle_trend_alert(data):
    """Обработка предупреждения о тренде"""
    trend = data.get('payload', {})
    print(f"Новый тренд: {trend}")

if __name__ == '__main__':
    app.run(port=5000)

Практические советы для интеграции

Оптимизация запросов

Совет 1: Кэшируйте данные

Не делайте запрос к API для каждого пользователя, который смотрит ваш дашборд. Кэшируйте данные:

import time
from functools import wraps

CACHE = {}
CACHE_DURATION = 3600  # 1 час

def cached_api_call(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        cache_key = f"{func.__name__}_{args}_{kwargs}"

        if cache_key in CACHE:
            cached_time, cached_data = CACHE[cache_key]
            if time.time() - cached_time < CACHE_DURATION:
                return cached_data

        result = func(*args, **kwargs)
        CACHE[cache_key] = (time.time(), result)
        return result

    return wrapper

@cached_api_call
def get_visibility():
    # Запрос к API
    pass

Совет 2: Используйте rate limiting

Шпиониро API имеет лимиты на количество запросов. Не превышайте их:

from ratelimit import limits, sleep_and_retry

@sleep_and_retry
@limits(calls=100, period=3600)  # 100 запросов в час
def make_api_request(endpoint):
    # Ваш запрос
    pass

Совет 3: Обрабатывайте ошибки

Не все запросы успешны. Обрабатывайте ошибки:

try:
    response = requests.get(url, headers=headers, timeout=10)
    response.raise_for_status()
except requests.exceptions.RequestException as e:
    print(f"Ошибка запроса: {e}")
    # Используйте кэшированные данные
except Exception as e:
    print(f"Неожиданная ошибка: {e}")

Безопасность

Совет 1: Не коммитьте API ключ в git

# .gitignore
.env
*.key
secrets/

Используйте переменные окружения:

import os

API_KEY = os.getenv('SPIONIRO_API_KEY')

Совет 2: Используйте HTTPS

Все запросы к API должны быть через HTTPS. Убедитесь, что вы не используете HTTP.

Совет 3: Проверяйте подписи вебхуков

Это защищает от подделанных вебхуков.

FAQ: API и интеграция

Какая цена за использование API?

API включена в про-подписку Шпиониро. Бесплатная подписка не имеет доступа к API.

Какие лимиты на количество запросов?

  • Pro план: 1000 запросов в день
  • Business план: 10,000 запросов в день
  • Enterprise: кастомные лимиты

Может ли я получать исторические данные?

Да, но есть ограничения:

  • Бесплатный период просмотра: последние 30 дней
  • Для Pro и выше: до 12 месяцев

Какой формат возвращает API?

JSON. Все responses в JSON формате.

Как мне дебажить API запросы?

Используйте инструменты как Postman или curl:

curl -X GET "https://api.spioniro.ru/v1/brands/123456/visibility?period=30" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Есть ли документация более подробная?

Да, полная документация API доступна на https://docs.spioniro.ru/api

Я получаю ошибку 401 Unauthorized. Что не так?

Проверьте:

  1. Правильно ли вы копировали API ключ (без пробелов)
  2. Используете ли вы активный ключ (может быть, старый был деактивирован)
  3. Правильный ли формат заголовка Authorization (должно быть "Bearer YOUR_KEY")

Могу ли я использовать API для коммерческого продукта?

Да, но прочитайте Terms of Service. Обычно есть некоторые ограничения на перепродажу API как сервиса.

Заключение: от API к результатам

API Шпиониро открывает безграничные возможности для интеграции мониторинга GEO в вашу систему. Будь то Slack уведомления, кастомный дашборд, интеграция с CRM или автоматизированные отчеты — вы теперь знаете, как это сделать.

Мы показали вам:

  1. Основные концепции и endpoints API
  2. Практические примеры на Python и JavaScript
  3. Как настроить вебхуки для уведомлений в реальном времени
  4. Советы по оптимизации и безопасности
  5. Ответы на часто задаваемые вопросы

Ваш следующий шаг:

  1. Получите API ключ в настройках Шпиониро
  2. Выберите один use case из примеров выше (например, Slack интеграцию)
  3. Адаптируйте код под вашу систему
  4. Запустите и тестируйте
  5. Расширяйте функциональность

Если вам нужна помощь с интеграцией API, свяжитесь с поддержкой

API Шпиониро — это ваш инструмент для автоматизации мониторинга GEO. Используйте её по максимуму.

Похожие статьи

Начните контролировать репутацию своего бренда в AI сегодня

Трафик из нейросетей — это не будущее, а реальность 2026 года. Зарегистрируйтесь и получите первый отчет по вашему бренду.

🎁25 кредитов в подарок

Без карты • Бесплатный доступ • Настройка за 2 минуты