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": "My Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Other Link", "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 часов. Повторные запросы к этой конечной точке не будут выдавать данные в реальном времени.

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

Для уведомлений о кликах в реальном времени см. Вебхуки. Вебхуки отправляют 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 — интеграции без кода