API Kratk

Автоматизируйте короткие ссылки, выгрузку данных и аналитику. Ниже — четыре готовых сценария с актуальными запросами cURL и примерами ответов.

Создать API-ключ

Аутентификация

Создайте ключ в кабинете на тарифе с доступом к API и передавайте его в каждом запросе:Authorization: Bearer YOUR_API_KEY. Полное значение показывается при создании — сохраните его в менеджере секретов и не вставляйте в браузерный код или репозиторий.

Базовый URL: https://kratk.ru/api. В примерах замените YOUR_API_KEY на свой ключ.

Готовые сценарии

POST

/links

Создать короткую ссылку

Один обязательный параметр — целевой url. Название, описание, customCode и domain необязательны.

UTM-метки передаются в query целевого url, отдельных UTM-полей в API нет.
Публичный адрес: https://{domain}/s/{shortCode}. Если clientPrefix заполнен, используйте https://{domain}/{clientPrefix}/{shortCode}.

Запрос cURL

curl -sS https://kratk.ru/api/links \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/product?utm_source=email&utm_medium=newsletter","title":"Товар"}'

Пример ответа 200

{
  "id": "9b4f...",
  "url": "https://example.com/product?utm_source=email&utm_medium=newsletter",
  "shortCode": "promo42",
  "domain": "kratk.ru",
  "hasPassword": false,
  "clientPrefix": null,
  "clickCount": 0
}

POST

/links/bulk

Создать ссылки пакетом

До 1000 ссылок за запрос. Каждая строка обрабатывается отдельно: ошибка одной не откатывает остальные.

Проверяйте created и errors по rowNumber, а также итоговый summary.
У успешных строк shortUrl уже содержит итоговый публичный адрес.

Запрос cURL

curl -sS https://kratk.ru/api/links/bulk \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"links":[{"url":"https://example.com/a","customCode":"promo-a"},{"url":"https://example.com/b?utm_source=email"}]}'

Пример ответа 200

{
  "created": [
    {
      "rowNumber": 1,
      "status": "created",
      "shortUrl": "https://kratk.ru/s/promo-a",
      "shortCode": "promo-a",
      "domain": "kratk.ru",
      "linkId": "9b4f..."
    },
    {
      "rowNumber": 2,
      "status": "created",
      "shortUrl": "https://kratk.ru/s/x7k2p9",
      "shortCode": "x7k2p9",
      "domain": "kratk.ru",
      "linkId": "c82a..."
    }
  ],
  "errors": [],
  "summary": { "requested": 2, "created": 2, "failed": 0 },
  "clientPrefix": null
}

GET

/links/export

Выгрузить ссылки в CSV

Скачайте CSV с коротким и полным URL, автором, кликами, тегами, статусом и датами создания и изменения.

Ответ — text/csv с UTF-8 BOM, а не JSON. Флаг -o сохраняет его в файл.
Необязательные фильтры: search, tag, linkIds, onlyMine, createdByUserId и type=links|deeplinks.

Запрос cURL

curl -sS https://kratk.ru/api/links/export \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o kratk-links.csv

Начало CSV-файла

shortUrl,shortCode,domain,url,title,clickCount,createdAt,updatedAt,tags,isActive,createdBy,createdByEmail
https://kratk.ru/s/promo42,promo42,kratk.ru,https://example.com/product,Товар,42,2026-11-01T12:00:00.000Z,2026-11-01T12:00:00.000Z,email,true,owner@example.com,owner@example.com

GET

/analytics?range=30d&granularity=day

Получить аналитику

Сводные показатели и серия кликов за период. По умолчанию используются 30 дней и группировка по дням.

Пресеты: today, yesterday, 7d, 30d, 90d, 3m, 6m, 12m, week и month. Группировка: day, week или month.
Для своего периода передайте start=YYYY-MM-DD и end=YYYY-MM-DD. На Free доступно окно до 30 дней.

Запрос cURL

curl -sS "https://kratk.ru/api/analytics?range=30d&granularity=day" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа 200

{
  "totalLinks": 10,
  "totalClicks": 150,
  "periodClicks": 42,
  "uniqueClicks": 37,
  "clickRate": 15,
  "clickData": [{ "date": "2026-11-05", "clicks": 12 }],
  "timeRange": "30d",
  "granularity": "day"
}

Для агентов

Полный справочник API одним файлом в Markdown: /docs/api/reference.md(индекс — /llms.txt).

Если запрос не проходит

Проверьте HTTP-статус и тело ошибки. Разбор кодов 400, 401, 403, 404, 429, 500 и 502 — в разделе «Ошибки и лимиты».

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

Не нашли ответ?

Напишите в поддержку — ответим в Telegram.

Открыть Telegram