> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analītika

> Skenēšanas statistika vienam QR kodam vai visai darbvietai.

> [!NOTE]
>
> 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](#qr-koda-analītikas-iegūšana) |
| `GET` | `/api/v1/analytics` | [Darbvietas analītikas iegūšana](#darbvietas-analītikas-iegūšana) |

Gatavu kopsavilkumu par katru QR kodu skatiet sadaļā [Atskaites](https://docs.getqr.com/lv/api/endpoints/reports.md).

## 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

**Authorization** `string` *required*

`Bearer`, kam seko jūsu API atslēga. Skatiet [Autentifikācija](https://docs.getqr.com/lv/api/authentication.md).

## Vaicājuma parametri

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

**groupBy** `string` (default: count)

Sadalījuma dimensija. `count` atgriež kopsummu. Visas vērtības un to atbilžu formu skatiet sadaļā [Sadalījumi](#sadalījumi).

**interval** `string` (default: 30d)

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

**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`.

**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.

**timezone** `string` (default: UTC)

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

**unique** `boolean` (default: false)

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

Varat sūtīt arī [dimensiju filtrus](#dimensiju-filtri).

## 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`:

```json theme={null}
{ "clicks": 142 }
```

Atbilde, kad `groupBy=countries`:

```json theme={null}
[
  { "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](#vaicājuma-parametri) un [dimensiju filtrus](#dimensiju-filtri).

**qrId** `string` *required*

QR koda ID. Ņemiet to no [QR kodu](https://docs.getqr.com/lv/api/endpoints/qr-codes.md) saraksta vai izveides atbildes.

```bash Total scans, last 30 days theme={null}
curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```bash Unique scans theme={null}
curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```bash By country, last 7 days theme={null}
curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
{
  "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](#vaicājuma-parametri) un [dimensiju filtrus](#dimensiju-filtri), kā arī šos tvēruma parametrus.

**domain** `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.

**key** `string`

Īsās saites slug, piemēram, `x7Kd2p1`. Izmantojiet to kopā ar `domain`. Abi ir atrodami [QR koda objektā](https://docs.getqr.com/lv/api/endpoints/qr-codes.md).

**qrType** `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](https://docs.getqr.com/lv/api/guides/qr-types.md).

```bash Devices, last 7 days theme={null}
curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```bash Devices, website QR codes only theme={null}
curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=30d&qrType=website" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```bash One short link theme={null}
curl "https://getqr.com/api/v1/analytics?groupBy=count&domain=getqr.sh&key=x7Kd2p1" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
[
  { "device": "Mobile", "clicks": 980 },
  { "device": "Desktop", "clicks": 240 }
]
```

## Biežākās problēmas

> [accordion] 400 "QR has no associated link."
>
> QR kodam nav īsās saites, tāpēc nav skenējumu, ko skaitīt.

> [accordion] 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.

> [accordion] 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.

> [accordion] 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.

## Kas tālāk

> [card] [Atskaites](https://docs.getqr.com/lv/api/endpoints/reports.md)

> [card] [QR kodi](https://docs.getqr.com/lv/api/endpoints/qr-codes.md)

> [card] [Analītika lietotnē](https://docs.getqr.com/lv/analytics/overview.md)

> [card] [Pieprasījumu ierobežojumi](https://docs.getqr.com/lv/api/rate-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.