Analītika

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
}

GetQR API ir beta versijā un pieejams atlasītām darbvietām. Līdz vispārējai izlaišanai detaļas var mainīties.

Iegūstiet skenējumu kopsummas un sadalījumus pa valstīm, ierīcēm, pārlūkprogrammām un citiem rādītājiem vienam QR kodam vai visai darbvietai.

Metode	Ceļš	Apraksts
`GET`	`/api/v1/qrs/{qrId}/analytics`	QR koda analītikas iegūšana
`GET`	`/api/v1/analytics`	Darbvietas analītikas iegūšana

Gatavu kopsavilkumu par katru QR kodu skatiet sadaļā Atskaites.

Ko nozīmē skaitļi

Skenējumi. Katrs skaits ir laukā clicks. Skenējums tiek ieskaitīts katru reizi, kad kāds atver QR koda īso saiti.
Unikālie skenējumi. Ar unique=true katrs apmeklētājs datumu diapazonā tiek ieskaitīts vienu reizi.
Tvērums. Skaitļi tiek iegūti no QR koda īsās saites. QR kodam bez īsās saites nav skenējumu, ko skaitīt.
Vēsture. Analītiku nevar atiestatīt ar API. QR koda dzēšana neizdzēš tā vēsturiskos skenējumu datus.

Galvenes

string

obligāts

Bearer, kam seko jūsu API atslēga. Skatiet Autentifikācija.

Vaicājuma parametri

Abi galapunkti pieņem šos parametrus. Neviens no tiem nav obligāts.

string

noklusējums:"count"

Sadalījuma dimensija. count atgriež kopsummu. Visas vērtības un to atbilžu formu skatiet sadaļā Sadalījumi.

string

noklusējums:"30d"

Iepriekš iestatīts datumu diapazons: 24h, 7d, 30d, 90d, 1y, mtd, qtd, ytd vai all. Skatiet Datumu diapazoni. Tiek ignorēts, ja sūtāt start.

string

Pielāgota diapazona sākums, ISO 8601, piemēram, 2026-08-01 vai 2026-08-01T00:00:00Z. Tam ir prioritāte pār interval. Jābūt agrākam par end.

string

Pielāgota diapazona beigas, ISO 8601. Noklusējums ir šodienas beigas. Tiek izmantots kopā ar start vai interval=all un ignorēts ar citiem intervāliem.

string

noklusējums:"UTC"

IANA laika josla timeseries intervālu izlīdzināšanai, piemēram, America/New_York. Nezināma laika josla atgriež 422.

boolean

noklusējums:"false"

true skaita unikālos skenējumus kopējo skenējumu vietā.

Varat sūtīt arī dimensiju filtrus.

Datumu diapazoni

`interval`	Aptver	`timeseries` intervāli
`24h`	Pēdējās 24 stundas	Stundas
`7d`	Pēdējās 7 dienas, ieskaitot šodienu	Dienas
`30d`	Pēdējās 30 dienas, ieskaitot šodienu	Dienas
`90d`	Pēdējās 90 dienas, ieskaitot šodienu	Dienas
`1y`	Pēdējās 365 dienas, ieskaitot šodienu	Mēneši
`mtd`	Mēneša sākums līdz šodienai	Dienas
`qtd`	Ceturkšņa sākums līdz šodienai	Dienas
`ytd`	Gada sākums līdz šodienai	Dienas vai mēneši pēc 180 dienām
`all`	Kopš darbvietas izveides	Dienas vai mēneši pēc 180 dienām

Pielāgotam diapazonam sūtiet start un pēc izvēles end. Diapazoni līdz 2 dienām izmanto stundu intervālus, diapazoni virs 180 dienām — mēnešu intervālus, bet viss starp tiem — dienu intervālus.

Dimensiju filtri

Sašauriniet rezultātus līdz skenējumiem, kas atbilst filtram. Dažādi filtri tiek apvienoti ar AND. Ja filtrs pieņem vairākas vērtības, atdaliet tās ar komatiem: vērtības tiek apvienotas ar OR.

Filtrs	Vērtība	Vairākas vērtības
`country`	ISO 3166-1 alpha-2 valsts kods, piemēram, `US`	Jā
`region`	ISO 3166-2 reģiona kods, piemēram, `US-CA`	Jā
`city`	Pilsētas nosaukums, piemēram, `New York`	Jā
`continent`	`AF`, `AN`, `AS`, `EU`, `NA`, `OC` vai `SA`	Jā
`device`	Ierīces veids, piemēram, `Mobile` vai `Desktop`	Jā
`browser`	Pārlūkprogrammas nosaukums, piemēram, `Chrome`	Jā
`os`	Operētājsistēma, piemēram, `iOS` vai `Windows`	Jā
`url`	Mērķa URL	Jā
`referer`	Novirzītājs, piemēram, `google.com`	Nē
`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`	UTM vērtība, līdz 190 rakstzīmēm	Nē

Nezināms valsts vai kontinenta kods atgriež 422. Ierīču, pārlūkprogrammu un OS nosaukumi tiek salīdzināti ar lielo sākumburtu, tāpēc mobile darbojas tāpat kā Mobile. Piemēram, skenējumi no ASV vai Kanādas mobilajās ierīcēs: ?country=US,CA&device=Mobile.

Sadalījumi

count atgriež objektu. Visas pārējās vērtības atgriež masīvu, kas sakārtots pēc clicks no lielākā uz mazāko (timeseries ir sakārtots pēc laika).

`groupBy`	Katrs elements satur
`count`	`clicks` (objekts, nevis masīvs)
`timeseries`	`start` (intervāla sākums), `clicks`
`continents`	`continent`, `clicks`
`regions`	`region`, `country`, `clicks`
`countries`	`country`, `city` (vienmēr `*`), `clicks`
`cities`	`city`, `country`, `clicks`
`devices`	`device`, `clicks`
`browsers`	`browser`, `clicks`
`os`	`os`, `clicks`
`triggers`	`trigger` (`qr` vai `link`), `clicks`
`referers`	`referer` (`(direct)`, ja nezināms), `clicks`
`referer_urls`	`refererUrl` (`(direct)`, ja nezināms), `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`	UTM vērtība (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term` vai `utm_content`), `clicks`

Nezināms groupBy atgriež 422 ar derīgo vērtību sarakstu. Atbilde, kad groupBy=count:

{ "clicks": 142 }

Atbilde, kad groupBy=countries:

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

QR koda analītikas iegūšana

GET /api/v1/qrs/{qrId}/analytics Atgriež skenēšanas statistiku vienam QR kodam, ierobežotu ar tā īso saiti. Pieņem iepriekš aprakstītos vaicājuma parametrus un dimensiju filtrus.

string

obligāts

QR koda ID. Ņemiet to no QR kodu saraksta vai izveides atbildes.

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
}

Darbvietas analītikas iegūšana

GET /api/v1/analytics Atgriež skenēšanas statistiku visiem jūsu darbvietas QR kodiem. Pieņem iepriekš aprakstītos vaicājuma parametrus un dimensiju filtrus, kā arī šos tvēruma parametrus.

string

Kopā ar key ierobežo rezultātus līdz īsajai saitei ar šo domēnu, piemēram, getqr.sh. Domēnam jāpieder jūsu darbvietai.

string

Īsās saites slug, piemēram, x7Kd2p1. Izmantojiet to kopā ar domain. Abi ir atrodami QR koda objektā.

string

Ar komatiem atdalīti iekļaujamie QR kodu veidi: website, pdf, image, video, whatsapp, social, wifi, app, feedback, vcard, sms, payment, location, multilink, email vai event. Skatiet QR kodu veidi.

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

Biežākās problēmas

400 "QR has no associated link."

QR kodam nav īsās saites, tāpēc nav skenējumu, ko skaitīt.

404, filtrējot pēc domain un key

Jūsu darbvietā nav īsās saites ar šādu domēnu un slug. Nokopējiet domain un key no QR koda objekta.

422 parametram groupBy, interval vai filtram

Vērtība netiek atbalstīta. Kļūdas ziņojumā norādīts parametrs un uzskaitītas derīgās vērtības.

Skaitļi nesakrīt ar informācijas paneli

Pārbaudiet, vai izmantojat to pašu datumu diapazonu un laika joslu un vai skaitāt unikālos skenējumus (unique=true) vai kopējos skenējumus.

API

Ko nozīmē skaitļi

Galvenes

Vaicājuma parametri

Datumu diapazoni

Dimensiju filtri

Sadalījumi

QR koda analītikas iegūšana

Darbvietas analītikas iegūšana

Biežākās problēmas

Kas tālāk

Atskaites

QR kodi

Analītika lietotnē

Pieprasījumu ierobežojumi

​Ko nozīmē skaitļi

​Galvenes

​Vaicājuma parametri

​Datumu diapazoni

​Dimensiju filtri

​Sadalījumi

​QR koda analītikas iegūšana

​Darbvietas analītikas iegūšana

​Biežākās problēmas

​Kas tālāk

Atskaites

QR kodi

Analītika lietotnē

Pieprasījumu ierobežojumi

Ko nozīmē skaitļi

Galvenes

Vaicājuma parametri

Datumu diapazoni

Dimensiju filtri

Sadalījumi

QR koda analītikas iegūšana

Darbvietas analītikas iegūšana

Biežākās problēmas

Kas tālāk