Data model
Business
Identity, contact, location, hours, branding, and social profiles for the business. Served as part of /reviews.json.
Fields
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | Stable internal business identifier. |
name | string | yes | Public display name. |
legal_name | string | yes | Registered legal entity name. |
tagline | string | yes | Short marketing line. May be empty. |
description | string | yes | Longer prose description. May be empty. |
domain | string | yes | Primary domain (host only, no scheme). |
categories | string[] | yes | Business categories. At least one. |
phone | string | yes | Primary contact phone. |
email | string (email) | yes | Contact email. |
website | string (url) | yes | Canonical website URL. |
google_place_id | string | yes | Google Place ID for the listing. |
google_maps_url | string (url) | yes | Link to the Google Maps listing. |
address | object | yes | Postal address (see nested fields below). |
address.street | string | yes | Street line. |
address.city | string | yes | City. |
address.state | string | yes | State / region. |
address.zip | string | yes | Postal code. |
address.country | string | yes | Country. |
geo | object | yes | Geographic coordinates. |
geo.lat | number | yes | Latitude (decimal degrees). |
geo.lng | number | yes | Longitude (decimal degrees). |
hours | object | yes | Keys monday…sunday; each value is "HH:MM-HH:MM" (24h) or "closed". |
branding | object | yes | Visual identity (see nested fields below). |
branding.primary_color | string (#RRGGBB) | yes | Brand color; drives the design system. |
branding.accent_color | string (#RRGGBB) | no | Legacy accent color. Optional; unused by current design system. |
branding.logo_url | string | yes | Logo image URL/path. |
branding.logo_wordmark_url | string | no | Optional editorial SVG wordmark shown in the header when present. |
branding.favicon_url | string | yes | Favicon URL/path. |
branding.style_tier | "standard" | "premium" | "custom" | no | Typography tier. Defaults to "standard". |
social | object | yes | Social profile URLs (each nullable). |
social.facebook | string (url) | null | yes | Facebook URL, or null. |
social.instagram | string (url) | null | yes | Instagram URL, or null. |
social.x | string (url) | null | yes | X / Twitter URL, or null. |
social.yelp | string (url) | null | yes | Yelp URL, or null. |
service_area | string[] | yes | Named areas served. May be empty. |
external_profiles | object | no | Optional sameAs reconciliation profiles (Google, Yelp, BBB, LinkedIn, Wikidata, etc.). All inner fields optional/nullable. |