Analytics API Linkly

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

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

Прежде чем начать

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

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

Авторизация

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

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

Linkly автоматически создает 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) считается одним запросом. Экспорт ссылок (/links/export), выполненный с помощью API ключа, также считается одним запросом.
• Сканированные данные: Объем данных, обработанных нашей базой данных аналитики для выполнения вашего запроса. Больший диапазон дат и более сложные запросы сканируют больше данных.

Что происходит при превышении ограничений

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

API запросы возвращают ошибку 429 Too Many Requests вместо этого при:

1. 1
   Рабочее пространство находится на плане Free или Starter, которые не могут добавлять API пакеты
2. 2
   Подписка рабочего пространства установлена на отмену или платеж просрочен
3. 3
   Рабочее пространство использовало все свое допустимое количество сканированных данных — API пакеты добавляют запросы, а не данные

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

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

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

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

Вам нужно больше?

Вы можете в любой момент добавить API пакеты самостоятельно в разделе Add-ons на странице Оплата. Каждый пакет добавляет дополнительные API запросы в каждом периоде выставления счетов; на странице отображается цена для вашего плана перед подтверждением.

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

Интеграция BigQuery

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

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

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

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

Связанное

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