Analytics API Linkly

Eksportuj dane kliknięć i raporty ruchu z Linkly programistycznie za pomocą naszego Analytics API.

Powiązane: Link Shortening API | Webhooks

Zanim zaczniesz

Linkly generuje żądania API w interfejsie, które możesz skopiować i wkleić do swoich aplikacji.

Zaoszczędź czas i pozwól nam wykonać trudną pracę. Nasze API jest w pełni konsumowalne przez maszyny.

Autoryzacja

Będziesz potrzebować swojego Klucza API i ID obszaru roboczego. Możesz uzyskać te szczegóły z poziomu Linkly.

API raportów ruchu

Linkly automatycznie generuje żądania API dla Ciebie w swoich raportach ruchu.

Raporty ruchu Linkly automatycznie tworzą żądania API dla Ciebie, na podstawie danych wyświetlanych na ekranie.

Te linki zawierają Twój klucz API i są łatwe do dostosowania oraz użycia w swoich aplikacjach.

Formaty wyjściowe

Analytics API obsługuje trzy formaty wyjściowe:

Tryb przestawny (format macierzy)

Domyślnie API zwraca dane szeregów czasowych z jednym wierszem na datę. W trybie przestawnym możesz uzyskać ruch wszystkich swoich linków w jednym żądaniu jako macierz.

Użyj listy rozwijanej Eksportuj dane w dowolnym raporcie ruchu, aby szybko wyeksportować dane według linku, lub dodaj pivot=link_id do swojego żądania API.

Dodaj pivot=link_id do swojego żądania, aby uzyskać dane z:

• Datami jako wiersze (jeden wiersz na dzień)
• Linkami jako kolumny (jedna kolumna na link)

Przykład wyjścia CSV/TSV w trybie przestawnym

Przykład wyjścia JSON w trybie przestawnym

{
  "links": [
    {"id": 123, "name": "Mój link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Inny 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}}
  ]
}

Tryb przestawny jest przydatny do:

• Porównywania ruchu na wielu linkach
• Importowania do arkuszy kalkulacyjnych do analizy
• Budowania pulpitów nawigacyjnych ze wszystkimi danymi linków w jednym wywołaniu

Surowe dane kliknięć

Dostępne są surowe dane kliknięć, które rejestrujemy, w tym pełne parametry, znaczniki czasu i informacje o geolokalizacji.

Aby uzyskać dostęp do tych danych, kliknij Eksportuj z zakładek na dole i wybierz swój format. To są w pełni sformułowane żądania API, które możesz używać bezpośrednio w swojej aplikacji.

Uwagi dotyczące eksportu danych

• Rozważ najpierw filtrowanie danych w widoku, aby zmniejszyć ilość eksportowanych danych. Ta funkcja eksportuje podstawowe dane używane do generowania aktualnie wyświetlanego raportu.
• Dane te są buforowane przez maksymalnie 3 godziny. Powtórzone żądania do tego punktu końcowego nie będą generować danych w czasie rzeczywistym.

Powiadomienia kliknięć w czasie rzeczywistym

Aby uzyskać powiadomienia kliknięć w czasie rzeczywistym, zobacz Webhooks. Webhooks wysyłają żądanie POST na określony adres URL (adresy URL) natychmiast po kliknięciu, ze szczegółowymi informacjami o kliknięciu.

Możesz również zarządzać webhookami za pośrednictwem API - zobacz specyfikację OpenAPI aby uzyskać szczegóły.

Polityka fair use

Limity szybkości

Analytics API jest ograniczona do 50 żądań na godzinę na obszar roboczy.

Limity użytkowania

Oprócz limitów szybkości, Analytics API ma limity użytkowania, które resetują się w każdym okresie rozliczeniowym:

Co liczy się jako użytkowanie

• Żądania API: Każde wywołanie punktów końcowych Analytics API (/clicks, /counters, /export) liczy się jako jedno żądanie.
• Skanowane dane: Ilość danych przetwarzanych przez naszą bazę danych analityki, aby spełnić Twoje żądanie. Większe zakresy dat i bardziej złożone zapytania skanują więcej danych.

Co się stanie, jeśli przekroczysz limity

Jeśli przekroczysz limity użytkowania:

1. 1
   Żądania API będą zwracać błąd 429 Too Many Requests
2. 2
   Twoje limity będą automatycznie resetować się na początku następnego okresu rozliczeniowego
3. 3
   Twoje linki będą nadal działać i śledzić kliknięcia normalnie

Porady dotyczące zmniejszenia użytkowania

Większość użytkowników może uzyskać wszystkie swoje dane w jednym żądaniu API za pomocą trybu przestawnego (pivot=link_id), który zwraca ruch wszystkich linków jako macierz w jednym wywołaniu.

• Użyj trybu przestawnego: Dodaj pivot=link_id, aby uzyskać ruch wszystkich linków w jednym żądaniu zamiast odpytywania każdego linku osobno
• Buforuj odpowiedzi: Przechowuj odpowiedzi API lokalnie zamiast pobierać te same dane wielokrotnie
• Użyj mniejszych zakresów dat: Odpytuj tylko potrzebne daty
• Grupuj żądania: Połącz wiele zapytań o linki w jedno żądanie za pomocą parametru link_ids

Potrzebujesz więcej?

Jeśli potrzebujesz wyższych limitów, porozmawiaj z nami za pośrednictwem widżetu wsparcia.

Integracja BigQuery

W celu analityki o dużych wolumenach Linkly oferuje integrację BigQuery, która zapewnia bezpośredni dostęp SQL do danych kliknięć.

• Dostęp do danych na żywo - Odpytuj dane kliknięć bezpośrednio w BigQuery z aktualizacjami w czasie rzeczywistym
• Nieograniczone zapytania - Brak limitów szybkości API; płacisz tylko za obliczenia BigQuery
• Niestandardowe raporty - Buduj pulpity nawigacyjne za pomocą Looker, Data Studio lub Tableau
• Konsolidacja danych - Łącz dane kliknięć z innymi metrykami biznesowymi

Integracja BigQuery jest dostępna w planie Enterprise. Skontaktuj się z nami aby uzyskać szczegóły.

Dowiedz się więcej o integracji BigQuery →

Powiązane

• Link Shortening API - Twórz i aktualizuj linki programistycznie
• Webhooks - Powiadomienia kliknięć w czasie rzeczywistym
• BigQuery Integration - Bezpośredni dostęp SQL do danych kliknięć
• Zapier Integration - Integracje bez kodu