Analityka

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "clicks": 142
}

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "clicks": 142
}

API GetQR jest w wersji beta i jest dostępne dla wybranych obszarów roboczych. Szczegóły mogą się zmienić przed ogólną premierą.

Pobieraj łączną liczbę skanowań i podziały według kraju, urządzenia, przeglądarki i innych wymiarów, dla pojedynczego kodu QR lub całego obszaru roboczego.

Metoda	Ścieżka	Opis
`GET`	`/api/v1/qrs/{qrId}/analytics`	Analityka kodu QR
`GET`	`/api/v1/analytics`	Analityka obszaru roboczego

Gotowe podsumowanie dla każdego kodu QR znajdziesz w sekcji Raporty.

Co oznaczają liczby

Skanowania. Każda liczba znajduje się w polu clicks. Skanowanie jest liczone za każdym razem, gdy ktoś otworzy krótki link kodu QR.
Unikalne skanowania. Z unique=true każdy odwiedzający jest liczony raz w danym zakresie dat.
Zakres danych. Liczby pochodzą z krótkiego linku kodu QR. Kod QR bez krótkiego linku nie ma skanowań do policzenia.
Historia. Analityki nie można zresetować przez API. Usunięcie kodu QR nie usuwa historycznych danych skanowań.

Nagłówki

string

wymagane

Bearer, a po nim Twój klucz API. Zobacz Uwierzytelnianie.

Parametry zapytania

Oba endpointy przyjmują te parametry. Wszystkie są opcjonalne.

string

domyślnie:"count"

Wymiar podziału. count zwraca sumę. Wszystkie wartości i kształt odpowiedzi dla każdej z nich opisuje sekcja Podziały.

string

domyślnie:"30d"

Predefiniowany zakres dat: 24h, 7d, 30d, 90d, 1y, mtd, qtd, ytd lub all. Zobacz Zakresy dat. Ignorowany, gdy wysyłasz start.

string

Początek niestandardowego zakresu, ISO 8601, np. 2026-08-01 lub 2026-08-01T00:00:00Z. Ma pierwszeństwo przed interval. Musi być wcześniejszy niż end.

string

Koniec niestandardowego zakresu, ISO 8601. Domyślnie koniec dzisiejszego dnia. Używany razem ze start lub interval=all, a przy pozostałych interwałach ignorowany.

string

domyślnie:"UTC"

Strefa czasowa IANA, według której wyrównywane są przedziały timeseries, np. America/New_York. Nieznana strefa czasowa zwraca 422.

boolean

domyślnie:"false"

true liczy unikalne skanowania zamiast łącznej liczby skanowań.

Możesz też wysyłać filtry wymiarów.

Zakresy dat

`interval`	Obejmuje	Przedziały `timeseries`
`24h`	Ostatnie 24 godziny	Godziny
`7d`	Ostatnie 7 dni, łącznie z dzisiejszym	Dni
`30d`	Ostatnie 30 dni, łącznie z dzisiejszym	Dni
`90d`	Ostatnie 90 dni, łącznie z dzisiejszym	Dni
`1y`	Ostatnie 365 dni, łącznie z dzisiejszym	Miesiące
`mtd`	Od początku miesiąca	Dni
`qtd`	Od początku kwartału	Dni
`ytd`	Od początku roku	Dni lub miesiące po 180 dniach
`all`	Od utworzenia Twojego obszaru roboczego	Dni lub miesiące po 180 dniach

Dla niestandardowego zakresu wyślij start i opcjonalnie end. Zakresy do 2 dni mają przedziały godzinowe, zakresy dłuższe niż 180 dni mają przedziały miesięczne, a wszystkie pośrednie mają przedziały dzienne.

Filtry wymiarów

Zawęź wyniki do skanowań pasujących do filtra. Różne filtry są łączone przez AND. Gdy filtr przyjmuje kilka wartości, oddziel je przecinkami: wartości są łączone przez OR.

Filtr	Wartość	Kilka wartości
`country`	Kod kraju ISO 3166-1 alpha-2, np. `US`	Tak
`region`	Kod regionu ISO 3166-2, np. `US-CA`	Tak
`city`	Nazwa miasta, np. `New York`	Tak
`continent`	`AF`, `AN`, `AS`, `EU`, `NA`, `OC` lub `SA`	Tak
`device`	Typ urządzenia, np. `Mobile` lub `Desktop`	Tak
`browser`	Nazwa przeglądarki, np. `Chrome`	Tak
`os`	System operacyjny, np. `iOS` lub `Windows`	Tak
`url`	Docelowy adres URL	Tak
`referer`	Strona odsyłająca, np. `google.com`	Nie
`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`	Wartość UTM, do 190 znaków	Nie

Nieznany kod kraju lub kontynentu zwraca 422. Nazwy urządzeń, przeglądarek i systemów są dopasowywane z wielką pierwszą literą, więc mobile działa tak samo jak Mobile. Na przykład skanowania z USA lub Kanady na urządzeniach mobilnych: ?country=US,CA&device=Mobile.

Podziały

count zwraca obiekt. Każda inna wartość zwraca tablicę posortowaną według clicks od największej do najmniejszej (timeseries jest sortowane według czasu).

`groupBy`	Każdy element zawiera
`count`	`clicks` (obiekt, a nie tablica)
`timeseries`	`start` (początek przedziału), `clicks`
`continents`	`continent`, `clicks`
`regions`	`region`, `country`, `clicks`
`countries`	`country`, `city` (zawsze `*`), `clicks`
`cities`	`city`, `country`, `clicks`
`devices`	`device`, `clicks`
`browsers`	`browser`, `clicks`
`os`	`os`, `clicks`
`triggers`	`trigger` (`qr` lub `link`), `clicks`
`referers`	`referer` (`(direct)`, gdy nieznana), `clicks`
`referer_urls`	`refererUrl` (`(direct)`, gdy nieznany), `clicks`
`top_links`	`id`, `domain`, `key`, `shortLink`, `url`, `createdAt`, `qr` (`id`, `qrType`, `title`), `clicks`
`top_urls`	`url`, `clicks`
`top_types`	`qr_type`, `clicks`
`utm_sources`, `utm_mediums`, `utm_campaigns`, `utm_terms`, `utm_contents`	Wartość UTM (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term` lub `utm_content`), `clicks`

Nieznana wartość groupBy zwraca 422 z listą prawidłowych wartości. Odpowiedź przy groupBy=count:

{ "clicks": 142 }

Odpowiedź przy groupBy=countries:

[
  { "country": "US", "city": "*", "clicks": 87 },
  { "country": "DE", "city": "*", "clicks": 31 },
  { "country": "GB", "city": "*", "clicks": 24 }
]

Analityka kodu QR

GET /api/v1/qrs/{qrId}/analytics Zwraca statystyki skanowań jednego kodu QR, ograniczone do jego krótkiego linku. Przyjmuje opisane wyżej parametry zapytania i filtry wymiarów.

string

wymagane

ID kodu QR. Weź je z odpowiedzi listy lub tworzenia w Kodach QR.

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "clicks": 142
}

Analityka obszaru roboczego

GET /api/v1/analytics Zwraca statystyki skanowań wszystkich kodów QR w Twoim obszarze roboczym. Przyjmuje opisane wyżej parametry zapytania i filtry wymiarów oraz poniższe parametry zawężające.

string

Razem z key ogranicza wyniki do krótkiego linku w tej domenie, np. getqr.sh. Domena musi należeć do Twojego obszaru roboczego.

string

Slug krótkiego linku, np. x7Kd2p1. Używaj go razem z domain. Oba znajdziesz w obiekcie kodu QR.

string

Typy kodów QR do uwzględnienia, oddzielone przecinkami: website, pdf, image, video, whatsapp, social, wifi, app, feedback, vcard, sms, payment, location, multilink, email lub event. Zobacz Typy kodów QR.

curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=30d&qrType=website" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/analytics?groupBy=count&domain=getqr.sh&key=x7Kd2p1" \
  -H "Authorization: Bearer $GETQR_API_KEY"

[
  { "device": "Mobile", "clicks": 980 },
  { "device": "Desktop", "clicks": 240 }
]

Typowe problemy

400 "QR has no associated link."

Kod QR nie ma krótkiego linku, więc nie ma skanowań do policzenia.

404 przy filtrowaniu według domain i key

W Twoim obszarze roboczym nie istnieje krótki link z tą domeną i slugiem. Skopiuj domain i key z obiektu kodu QR.

422 przy groupBy, interval lub filtrze

Ta wartość nie jest obsługiwana. Komunikat błędu podaje nazwę parametru i listę prawidłowych wartości.

Liczby nie zgadzają się z panelem

Sprawdź, czy używasz tego samego zakresu dat i strefy czasowej oraz czy liczysz unikalne skanowania (unique=true), czy łączną liczbę skanowań.

API

Co oznaczają liczby

Nagłówki

Parametry zapytania

Zakresy dat

Filtry wymiarów

Podziały

Analityka kodu QR

Analityka obszaru roboczego

Typowe problemy

Co dalej

Raporty

Kody QR

Analityka w aplikacji

Limity żądań

​Co oznaczają liczby

​Nagłówki

​Parametry zapytania

​Zakresy dat

​Filtry wymiarów

​Podziały

​Analityka kodu QR

​Analityka obszaru roboczego

​Typowe problemy

​Co dalej

Raporty

Kody QR

Analityka w aplikacji

Limity żądań

Co oznaczają liczby

Nagłówki

Parametry zapytania

Zakresy dat

Filtry wymiarów

Podziały

Analityka kodu QR

Analityka obszaru roboczego

Typowe problemy

Co dalej