Dokumentacja API

Create an API key in your account, then call LinkBit with x-api-key or Authorization: Bearer. Public docs never show your keys.

Jak używać

REST API

W każdym żądaniu wyślij x-api-key albo Authorization: Bearer slk_...

x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

Przykłady żądań

▸Skróć URL (jeden)

Utwórz jeden krótki link. Własny slug jest opcjonalny (litery, cyfry, myślnik, min. 1 znak).

curl -X POST https://linkbit.live/api/v1/links \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"destination": "https://example.com/long-url", "slug": "my-link", "utm_source": "newsletter"}'

▸Masowe skracanie (do 100 w planie)

Utwórz wiele linków w jednym żądaniu. Błędy wracają w errors; poprawne i tak powstają.

curl -X POST https://linkbit.live/api/v1/links/bulk \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"urls": [
    {"destination": "https://example.com/page1"},
    {"destination": "https://example.com/page2", "slug": "my-custom-slug"}
  ]}'

▸Lista linków

Zwraca wszystkie krótkie linki tego klucza, od najnowszych, ze shortUrl i liczbą kliknięć.

curl https://linkbit.live/api/v1/links \
  -H "x-api-key: YOUR_API_KEY"

▸Statystyki kliknięć

Użyj id z tworzenia lub listy. Zwraca kliknięcia, unikalnych, kraje, urządzenia, źródła i dane dzienne.

curl "https://linkbit.live/api/v1/links/LINK_ID/stats?from=2026-01-01&to=2026-01-31" \
  -H "x-api-key: YOUR_API_KEY"

▸Przegląd analityki

Podsumowanie konta: top linki, dane dzienne, kraje, urządzenia, źródła.

curl https://linkbit.live/api/v1/analytics \
  -H "x-api-key: YOUR_API_KEY"

Pola

Pole	Gdzie	Uwagi
destination	create / bulk	Wymagane. URL http(s). Alias: url
slug	create / bulk	Opcjonalne. a-z, 0-9, myślnik. Min. 1 znak. Spacje stają się myślnikami.
utm_source … utm_content	create / bulk / CSV	Optional. Stored on the destination URL. Existing utm_* query params are not overwritten. Hash fragments are kept.
urls	bulk body	Tablica linków. Alias: links
created / errors	bulk response	Udane wiersze i błędy walidacji (index, message).

Błąd autoryzacji: 401. Zły input: 400. Brak id statystyk: 404.