Analityka API Linkly

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

Powiązane: Link Shortening API | Webhooks

Zanim zaczniesz

Linkly generuje żądania API w interfejsie, abyś mógł je skopiować i wkleić do swoich aplikacji.

Zaoszczędź czas i pozwól nam wykonać całą pracę. Nasz API jest całkowicie maszynowo-odczytywalne.

Jak zacząć pracę z Analytics API

1

Otwórz dowolny raport ruchu w Linkly.

2

Skopiuj żądanie API wyświetlane na górze raportu.

Format danych wyjściowych to CSV. Ten link zawiera Twój klucz API.

Te linki znajdują się obok każdej tabeli i wykresu w Linkly.

3

Poproś ChatGPT lub odpowiednik, aby dostosował te żądania do kodu źródłowego dla Twojej aplikacji.

Nie ma potrzeby spędzania czasu na złożonej integracji.

Autoryzacja

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

Jak znaleźć swoje dane uwierzytelniające API

1

Zaloguj się do Linkly.

2

Kliknij Ustawienia.

3

Kliknij Klucze API.

Traffic Reports API

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

Linkly's Traffic Reports API
Linkly's Traffic Reports API

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

Te linki zawierają Twój klucz API i są łatwo dostosowywalne oraz użyteczne w Twoich własnych aplikacjach.

Formaty danych wyjściowych

Analytics API obsługuje trzy formaty danych wyjściowych:

FormatParametrOpis
JSONformat=json (domyślnie)Dane strukturyzowane dla aplikacji
CSVformat=csvWartości oddzielone przecinkami dla arkuszy kalkulacyjnych
TSVformat=tsvWartości oddzielone tabulatorami, idealne do przeglądania przeglądarką i wklejania do arkuszy kalkulacyjnych

Pivot Mode (Format macierzy)

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

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

Export Data dropdown
Export Data dropdown

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

  • Datami jako wierszami (jeden wiersz na dzień)
  • Linkami jako kolumnami (jedna kolumna na link)

Przykład danych wyjściowych CSV/TSV Pivot

Mój linkInny link
nameMój linkInny link
full_urlhttps://linkly.link/abchttps://linkly.link/xyz
id123456
2025-12-304512
2025-12-31528
2026-01-013815

Przykład danych wyjściowych JSON Pivot

{
  "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}}
  ]
}

Tryb pivot jest przydatny do:

  • Porównywania ruchu między wieloma linkami
  • Importowania do arkuszy kalkulacyjnych do analizy
  • Budowania pulpitów nawigacyjnych ze wszystkimi danymi linków w jednym wywołaniu

Surowe dane kliknięć

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

Aby uzyskać dostęp do tych danych, kliknij Eksportuj z kart 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 Twojej aplikacji.

Export Raw Data
Export Raw Data
Raw Click Data Example
Raw Click Data Example

Uwagi dotyczące eksportu danych

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

Powiadomienia o kliknięciach w czasie rzeczywistym

Aby otrzymywać powiadomienia o kliknięciach w czasie rzeczywistym, zobacz Webhooks. Webhooks wysyłają żądanie POST do Twojego określonego adresu 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 ograniczone 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:

Typ planuŻądania APISkanowane dane
Bezpłatny100/miesiąc10 GB/miesiąc
Płatny miesięczny2000/miesiąc2 TB/miesiąc
Płatny roczny24000/rok24 TB/rok
Miesięczny Unlimited10000/miesiąc2 TB/miesiąc
Roczny Unlimited120000/rok24 TB/rok

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 w celu spełnienia Twojego żądania. Większe zakresy dat i bardziej złożone zapytania skanują więcej danych.

Co się dzieje, gdy przekroczysz limity

Jeśli przekroczysz limity użytkowania:

  1. 1Żądania API będą zwracać błąd 429 Too Many Requests
  2. 2Twoje limity automatycznie się resetują na początku następnego okresu rozliczeniowego
  3. 3Twoje 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 używając trybu pivot (pivot=link_id), który zwraca ruch wszystkich linków jako macierz w jednym wywołaniu.

  • Użyj trybu pivot: Dodaj pivot=link_id, aby uzyskać ruch dla wszystkich linków w jednym żądaniu zamiast wysyłać zapytania dla każdego linku osobno
  • Buforuj odpowiedzi: Przechowuj odpowiedzi API lokalnie zamiast pobierać te same dane wielokrotnie
  • Użyj mniejszych zakresów dat: Wysyłaj zapytania tylko dla dat, których potrzebujesz
  • Żądania grupowe: Łącz wiele zapytań o linki w jednym żądaniu za pomocą parametru link_ids

Potrzebujesz więcej?

Jeśli potrzebujesz wyższych limitów, skontaktuj się z nami za pomocą widżetu wsparcia.

Integracja BigQuery

W przypadku potrzeb analityki na dużą skalę, Linkly oferuje integrację BigQuery, która zapewnia bezpośredni dostęp SQL do danych kliknięć.

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

Integracja BigQuery jest bezpłatna dla klientów planu Unlimited lub dostępna jako dodatek za 100 USD/miesiąc dla innych planów.

Dowiedz się więcej o integracji BigQuery →

Powiązane

Śledź 500 kliknięć miesięcznie ze wszystkimi funkcjami włączonymi.

Karta kredytowa nie wymagana