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


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


{
  "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.