Data model
Review
A single verified customer review. The full array is served at /reviews.json and searchable via the REST API.
Fields
| Field | Type | Required | Notes |
|---|---|---|---|
id | string (ULID) | yes | Stable identifier and merge key — survives across re-scrapes. |
author | string | yes | Reviewer display name. |
author_avatar_url | string (url) | null | yes | Reviewer avatar image, or null when unavailable. |
rating | integer (1–5) | yes | Star rating, whole number 1 to 5. |
date | string (YYYY-MM-DD) | yes | Review date. |
text | string | null | yes | Review body. Null for rating-only reviews with no text. |
source | string | yes | Origin of the review, e.g. "google". |
source_url | string (url) | null | yes | Permalink to the original review, or null. |
owner_reply | object | null | yes | Business owner response, or null when there is none. |
owner_reply.text | string | yes | Reply body. Present only when owner_reply is set. |
owner_reply.date | string (YYYY-MM-DD) | yes | Reply date. Present only when owner_reply is set. |
verified | boolean | yes | Whether the review is from a verified source. |