# List daily Google Business Profile metrics

`GET /google-interactions`

Returns one row per shop and per day with the Google Business Profile
metrics: profile views (Search and Maps, mobile and desktop), website
clicks, calls and direction requests. Sorted by day descending.
Data is refreshed nightly from Google and may lag up to 24 hours.

Requires the `google_interactions:read` scope.

**Returns** a `data` array of up to `limit` shop-day rows and a
`pagination` object. Fetch the next page by passing
`pagination.next_cursor` back as `cursor`, until `has_more` is
`false`. `data` is empty when nothing matches the filters.

`views_total` is the sum of the four view metrics of the row. When
querying several shops at once, group rows by `shop_id` client-side to
rebuild per-shop series.

## Example request

```bash
curl "https://api.dokaa.app/v1/google-interactions" \
  -H "Authorization: Bearer dk_live_..."
```

## Query parameters

- `shop_id` (string) – Restrict to a single shop (omit to query all your shops)
- `from` (string) (format: date) – Only days on or after this date
- `to` (string) (format: date) – Only days on or before this date
- `cursor` (string) – Opaque cursor from the previous response's `pagination.next_cursor`
- `limit` (integer) (default: 25; min: 1; max: 100) – Number of items per page

## Responses

### 200 – Paginated list of daily metric rows

```json
{
  "data": [
    {
      "id": "66a7b8c9d0e1f2a3b4c5d6e7",
      "shop_id": "64f1a2b3c4d5e6f7a8b9c0d1",
      "date": "2026-08-05",
      "views_total": 1240,
      "views_search_mobile": 620,
      "views_search_desktop": 180,
      "views_maps_mobile": 370,
      "views_maps_desktop": 70,
      "website_clicks": 45,
      "calls": 12,
      "direction_requests": 38
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false
  }
}
```

### 401 – Missing, invalid, or revoked API key

### 403 – The API key does not grant access to this resource

### 422 – Invalid request parameters

Errors are `application/problem+json` (RFC 9457) with `type`, `title`, `status` and `detail` fields.