POST AI agent ready /v1/short-url/stats

API статистики коротких URL – бесплатная аналитика кликов

Отправьте фрагмент сокращенного URL-адреса и получите количество кликов, исходный URL-адрес и временную метку создания. Используйте это для отслеживания взаимодействия по ссылкам, созданным через конечную точку /v1/short-url/create. Статистика обновляется в режиме реального времени, когда пользователи нажимают на короткую ссылку.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/short-url/stats \
  -H "Content-Type: application/json" \
  -d '{"slug":"getting-started"}'

When to use this API

Отслеживайте эффективность ссылок кампании на панели администратора.

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

Запуск автоматизации, когда ссылка достигает порога кликов

Периодически проверяйте количество кликов. Когда ссылка пересекает пороговое значение (например, 1000 кликов), активируйте уведомление, поверните ссылку или обновите таблицу лидеров.

Создайте страницу отчетов для общих ссылок.

Покажите создателям ссылок, сколько кликов получили их короткие URL-адреса. Отобразите исходный URL-адрес, дату создания и общее количество кликов в простом аналитическом представлении.

Frequently asked questions

Обновляется ли количество кликов в реальном времени?

Да. Счетчик увеличивается при каждом перенаправлении. Может возникнуть задержка в доли секунды из-за возможной согласованности в хранилище значений ключей, но для практических целей она происходит мгновенно.

Можно ли сбросить счетчик кликов?

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

Что произойдет, если слизняка не существует?

API возвращает ошибку 404 с кодом NOT_FOUND. Дважды проверьте написание фрагмента или создайте новую короткую ссылку.

Подсчитывает ли конечная точка статистики трафик ботов отдельно?

Нет. Счетчик кликов отслеживает все запросы на перенаправление, включая запросы ботов, сканеров и сборщиков предварительного просмотра. При необходимости фильтруйте трафик ботов на вашей стороне.

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

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

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.