Analityka API Linkly

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

Powiązane: Link Shortening API | Webhoki

Zanim zaczniesz

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

Oszczędź czas i pozwól nam wykonać ciężką pracę. Nasze API jest całkowicie czytelne dla maszyn.

Autoryzacja

Będziesz potrzebować swojego klucza API i identyfikatora obszaru roboczego. Możesz uzyskać te szczegóły wewnątrz Linkly.

API raportów ruchu

Linkly automatycznie generuje żądania API dla Ciebie wewnątrz Twoich raportów ruchu.

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

Te linki zawierają Twój klucz API i są łatwe do dostosowania i używania w Twoich 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 dzień. 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 wierszami (jeden wiersz na dzień)
• Linkami jako kolumnami (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 dla:

• 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, sygnatury czasowe i informacje o geolokalizacji.

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

Notatki dotyczące eksportu danych

• Rozważ filtowanie danych w widoku najpierw, aby zmniejszyć ilość eksportowanych danych. Ta funkcja eksportuje dane bazowe używane 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ą tworzyć danych w czasie rzeczywistym.

Zliczenia grupowane

Punkt końcowy /counters/{dimension} zwraca sumy kliknięć pogrupowane według jednego wymiaru — takiego jak country, platform, destination, referer, isp lub link_id. Wyniki zwracane są posortowane według liczby kliknięć, od największej.

Zwracany jest maksymalnie 10 000 wartości. Wymiary o wysokiej kardynalności — destination, referer, remote_ip i isp — mogą mieć znacznie więcej odrębnych wartości na zajętym obszarze roboczym. Jeśli tak, otrzymasz top 10 000 według liczby kliknięć, a reszta nie zostanie zwrócona.

Pole total to zawsze całkowita liczba kliknięć we wszystkich grupach, w tym żadnych nieznanych. Tak więc na wyniku obciętym wartości count będą sumować się do mniej niż total — co oznacza, że procent obliczony jako count / total jest nadal dokładny.

Jeśli potrzebujesz pełnego zestawu wartości zamiast top 10 000, wyeksportuj surowe dane kliknięć i zagreguj je sam, lub użyj integracji BigQuery.

Powiadomienia o kliknięciach w czasie rzeczywistym

Aby uzyskać powiadomienia o kliknięciach w czasie rzeczywistym, zapoznaj się z artykułem Webhoki. Webhoki wysyłają żądanie POST na określony adres URL(e) natychmiast po kliknięciu z szczegółowymi informacjami o kliknięciu.

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

Polityka uczciwego użytkowania

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:

Co liczy się jako użytkowanie

• Żądania API: Każde wywołanie do punktów końcowych Analytics API (/clicks, /counters, /export) liczy się jako jedno żądanie. Eksporty linków (/links/export) wykonane za pomocą klucza API również liczy się jako jedno żądanie.
• Zeskanowane dane: Ilość danych przetworzonych 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ę stanie, gdy przekroczysz limity

Gdy obszar roboczy w planie płatnym zużyje wszystkie swoje żądania API, automatycznie dodajemy pakiet API do jego subskrypcji, aby Twoje integracje nadal działały, i wysyłamy wiadomość e-mail do członków obszaru roboczego, aby ich poinformować. Pakiet API dodaje dodatkowe żądania API każdego okresu rozliczeniowego, aż go usuniesz.

Żądania API zamiast tego zwracają błąd 429 Too Many Requests, gdy:

1. 1
   Obszar roboczy znajduje się w planie Darmowy lub Starter, które nie mogą dodawać pakietów API
2. 2
   Subskrypcja obszaru roboczego jest ustawiona na anulowanie, lub opłata jest zaległa
3. 3
   Obszar roboczy wykorzystał całe swoje przydzielenie zeskanowanych danych — pakiety API dodają żądania, a nie dane

Limity użytkowania resetują się na początek każdego okresu rozliczeniowego, a Twoje linki nadal działają i śledą kliknięcia normalnie w każdym przypadku.

Porady dotyczące zmniejszenia użycia

Większość użytkowników może uzyskać wszystkie swoje dane w jednym żądaniu API przy użyciu 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 dla wszystkich linków w jednym żądaniu zamiast odpytywać każdy link osobno
• Buforuj odpowiedzi: Przechowuj odpowiedzi API lokalnie zamiast wielokrotnie pobierać te same dane
• Używaj mniejszych zakresów dat: Pytaj tylko o daty, które Ci potrzebne
• Batch żądania: Łącz wiele zapytań linków w jednym żądaniu za pomocą parametru link_ids

Potrzebujesz więcej?

Możesz w każdej chwili dodać pakiety API w sekcji Add-ons na stronie Płatności. Każdy pakiet dodaje dodatkowe żądania API każdego okresu rozliczeniowego; strona pokazuje cenę dla Twojego planu przed potwierdzeniem.

Pakiety API nie zmieniają limitu szybkości. Jeśli potrzebujesz wyższego limitu szybkości, skontaktuj się z nami za pomocą widżetu obsługi.

Integracja BigQuery

Aby uzyskać wysokowolumenowe potrzeby analityki, Linkly oferuje integrację BigQuery, która zapewnia bezpośredni dostęp SQL do danych kliknięć.

• Dostęp do danych na żywo - Pytaj swoje 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 raportowanie - Buduj pulpity nawigacyjne za pomocą Lookera, Data Studio lub Tableau
• Konsolidacja danych - Łącz dane kliknięć z innymi wskaźnikami biznesowymi

Integracja BigQuery jest dołączona do planu 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 programowo
• Webhoki - Powiadomienia o kliknięciach w czasie rzeczywistym
• Integracja BigQuery - Bezpośredni dostęp SQL do danych kliknięć
• Integracja Zapier - Integracje bez kodu