Analytics API от Linkly

Экспортируйте данные кликов и отчеты трафика из Linkly программным способом с помощью нашего Analytics API.

Связанные материалы: API сокращения ссылок | Вебхуки

Перед началом работы

Linkly генерирует API-запросы в интерфейсе, которые вы можете скопировать и вставить в свои приложения.

Экономьте время и позвольте нам сделать тяжелую работу. Наш API полностью готов к использованию машинами.

Авторизация

Вам потребуются ваш API ключ и идентификатор рабочей области. Вы можете получить эти данные в Linkly.

API отчетов о трафике

Linkly автоматически создает API-запросы для вас внутри отчетов о трафике.

API отчетов о трафике Linkly автоматически создает API-запросы для вас, на основе данных, отображаемых на экране.

Эти ссылки включают ваш API ключ и легко настраиваются для использования в ваших приложениях.

Форматы вывода

Analytics API поддерживает три формата вывода:

Режим сводки (матричный формат)

По умолчанию API возвращает временные ряды с одной строкой на дату. В режиме сводки вы можете получить весь трафик ваших ссылок в одном запросе в виде матрицы.

Используйте раскрывающееся меню Экспортировать данные в любом отчете о трафике для быстрого экспорта данных по ссылке или добавьте pivot=link_id к вашему API-запросу.

Добавьте pivot=link_id к вашему запросу, чтобы получить данные с:

• Датами в строках (одна строка на день)
• Ссылками в столбцах (один столбец на ссылку)

Пример вывода CSV/TSV в режиме сводки

Пример вывода JSON в режиме сводки

{
  "links": [
    {"id": 123, "name": "Моя ссылка", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Другая ссылка", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

Режим сводки полезен для:

• Сравнения трафика по нескольким ссылкам
• Импорта в электронные таблицы для анализа
• Создания панелей мониторинга со всеми данными ссылок в одном вызове

Исходные данные кликов

Доступны исходные данные кликов, которые мы записываем, включая полные параметры, временные метки и информацию о геолокации.

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

Примечания относительно экспорта данных

• Рассмотрите возможность фильтрации данных в представлении сначала, чтобы снизить объем экспортируемых данных. Эта функция экспортирует исходные данные, используемые для создания отчета, который в настоящее время отображается на экране.
• Эти данные кэшируются на срок до 3 часов. Повторные запросы к этой конечной точке не будут предоставлять данные в реальном времени.

Сгруппированные подсчеты

Конечная точка /counters/{dimension} возвращает общее количество кликов, сгруппированное по одному измерению — например, country, platform, destination, referer, isp или link_id. Результаты возвращаются в порядке убывания количества кликов.

Максимум возвращается 10 000 значений. Измерения с высокой кардинальностью — destination, referer, remote_ip и isp — могут иметь гораздо больше отдельных значений на занятой рабочей области. Если это так, вы получаете топ 10 000 по количеству кликов, остальное не возвращается.

Поле total всегда содержит общее количество кликов по всем группам, включая те, которые не возвращены. Таким образом, при усеченном результате значения count будут складываться в сумму менее total — что означает, что процент, рассчитанный как count / total, все еще точен.

Если вам нужен полный набор значений, а не топ 10 000, экспортируйте исходные данные кликов и агрегируйте их самостоятельно или используйте интеграцию с BigQuery.

Уведомления кликов в реальном времени

Для уведомлений кликов в реальном времени см. Вебхуки. Вебхуки отправляют POST-запрос на указанные вами URL-адреса сразу же после клика с подробной информацией о клике.

Вы также можете управлять вебхуками через API — см. спецификацию OpenAPI для получения деталей.

Политика добросовестного использования

Ограничения скорости

Analytics API ограничена 50 запросами в час на рабочую область.

Лимиты использования

В дополнение к ограничениям скорости, Analytics API имеет лимиты использования, которые сбрасываются каждый период выставления счетов:

Что считается использованием

• API запросы: Каждый вызов конечных точек Analytics API (/clicks, /counters, /export) считается одним запросом.
• Отсканировано данных: Количество данных, обработанных нашей аналитической базой данных для выполнения вашего запроса. Более крупные диапазоны дат и более сложные запросы сканируют больше данных.

Что происходит при превышении лимитов

Если вы превышаете лимиты использования:

1. 1
   API запросы будут возвращать ошибку 429 Too Many Requests
2. 2
   Ваши лимиты автоматически сбросятся в начале вашего следующего периода выставления счетов
3. 3
   Ваши ссылки будут продолжать работать и отслеживать клики в нормальном режиме

Советы по снижению использования

Большинство пользователей могут получить все свои данные в одном API запросе с помощью режима сводки (pivot=link_id), который возвращает трафик всех ссылок в виде матрицы в одном вызове.

• Используйте режим сводки: Добавьте pivot=link_id, чтобы получить трафик всех ссылок в одном запросе, вместо запроса каждой ссылки отдельно
• Кэшируйте ответы: Сохраняйте ответы API локально, вместо многократной выборки одних и тех же данных
• Используйте меньшие диапазоны дат: Запрашивайте только нужные вам даты
• Группируйте запросы: Объединяйте несколько запросов ссылок в один запрос, используя параметр link_ids

Нужно больше?

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

Интеграция с BigQuery

Для высокообъемных аналитических потребностей Linkly предлагает интеграцию с BigQuery, которая обеспечивает прямой доступ к SQL к вашим данным кликов.

• Доступ к данным в реальном времени - Запрашивайте данные кликов непосредственно в BigQuery с обновлениями в реальном времени
• Неограниченные запросы - Нет ограничений скорости API; вы платите только за вычисления BigQuery
• Пользовательские отчеты - Создавайте панели мониторинга с помощью Looker, Data Studio или Tableau
• Консолидация данных - Объединяйте данные кликов с другими бизнес-метриками

Интеграция с BigQuery включена в план Enterprise. Свяжитесь с нами для получения подробной информации.

Узнайте больше об интеграции с BigQuery →

Связанные материалы

• API сокращения ссылок - Создание и обновление ссылок программным способом
• Вебхуки - Уведомления кликов в реальном времени
• Интеграция с BigQuery - Прямой доступ к SQL к данным кликов
• Интеграция с Zapier - Интеграции без кода