Analityka API Linkly

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

Pokrewne: Link Shortening API | Webhooks

Zanim zaczniesz

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

Zaoszczędź czas i pozwól nam zrobić ciężką pracę. Nasz API jest całkowicie maszynowy.

Autoryzacja

Będziesz potrzebować API Key i Workspace ID. Możesz uzyskać te informacje wewnątrz Linkly.

Raport ruchu API

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

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

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

Formaty wyjściowe

Analityka API obsługuje trzy formaty wyjściowe:

Tryb pivot (format macierzy)

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

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

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

• Daty jako wiersze (jeden wiersz na dzień)
• Linki jako kolumny (jedna kolumna na link)

Przykład wyjścia pivot CSV/TSV

Przykład wyjścia 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 ze wszystkimi danymi linków w jednym wywołaniu

Surowe dane kliknięć

Dostępne są surowe dane kliknięć, które zapisujemy, zawierające pełne parametry, sygnatury czasowe i informacje o geolokalizeacji.

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

Uwagi dotyczące eksportu danych

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

Zliczone grupy

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

Zwracane jest maksymalnie 10 000 wartości. Wymiary o dużej kardynalności — destination, referer, remote_ip i isp — mogą mieć znacznie więcej różnych wartości na zajętej przestrzeni roboczej. W takim razie otrzymujesz 10 000 głównych wg liczby kliknięć, a reszta nie jest zwracana.

Pole total zawsze jest całkowitą liczbą kliknięć we wszystkich grupach, w tym tych nie zwracanych. Dlatego na obciętym wyniku wartości count będą się sumować na mniej niż total — co oznacza, że procent obliczony jako count / total jest nadal dokładny.

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

Powiadomienia kliknięć w czasie rzeczywistym

Aby otrzymywać powiadomienia o kliknięciach w czasie rzeczywistym, zobacz Webhooks. Webhooki wysyłają żądanie POST na określony adres 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 szczegóły.

Zasada fair use

Limity szybkości

Analityka API jest ograniczona do 50 żądań na godzinę na przestrzeń roboczą.

Limity użycia

Oprócz limitów szybkości, Analityka API ma limity użycia, które resetują się każdy okres rozliczeniowy:

Co się liczy jako użycie

• Żądania API: Każde wywołanie do punktów końcowych Analityki 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życia:

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

Porady, aby zmniejszyć użycie

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

Potrzebujesz więcej?

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

Integracja BigQuery

Dla potrzeb analityki o dużej objętości Linkly oferuje integrację BigQuery, która zapewnia bezpośredni dostęp SQL do Twoich danych kliknięć.

• Dostęp do aktualnych danych - Pytaj bezpośrednio Twoje dane kliknięć w BigQuery z aktualizacjami w czasie rzeczywistym
• Nieograniczone zapytania - Brak limitów szybkości API; płacisz tylko za compute BigQuery
• Raportowanie niestandardowe - Buduj pulpity z Looker, Data Studio lub Tableau
• Konsolidacja danych - Łącz dane kliknięć z innymi metrykami biznesowymi

Integracja BigQuery jest dołączona do planu Enterprise. Skontaktuj się z nami aby uzyskać szczegóły.

Dowiedz się więcej o integracji BigQuery →

Pokrewne

• Link Shortening API - Utwórz i aktualizuj linki programowo
• Webhooks - Powiadomienia o kliknięciach w czasie rzeczywistym
• Integracja BigQuery - Bezpośredni dostęp SQL do danych kliknięć
• Integracja Zapier - Integracje bez kodu