List your Business Profiles

Request

GET https://api.hallie.app/v1/profiles

The rating figures are Google's own and cover every review the profile has ever had — not only the ones mirrored here. If your client already sent you a profile id, skip this call: they can copy it from their dashboard, on the profile's Reviews tab.

Query parameters

Parameter	Values	Default	Description
per_page	1–100	25	Reviews per page.
page	integer	1	Which page to read. The response also links to the next one.

Response

{
  "data": [
    {
      "id": "bp_01jd8x2kqe7yq3m4v5n6p7r8s9",
      "name": "Joe's Bakery",
      "address": "12 rue de la Paix, 69001, Lyon",
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "profile_url": "https://maps.google.com/?cid=1234567890",
      "review_url": "https://search.google.com/local/writereview?placeid=ChIJN1t_tDeuEmsRUsoyG83frY4",
      "rating": { "average": 4.7, "count": 213 },
      "reviews_synced_at": "2026-07-28T03:14:00+00:00",
      "published": true,
      "unpublished_since": null
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": null },
  "meta": { "current_page": 1, "last_page": 1, "per_page": 25, "total": 1 }
}

Field	What it is for
id	The value to put in the reviews URL.
name	The business name as it stands on Google.
address	The postal address, on one line. Null for a business that serves an area rather than a storefront.
place_id	Google's Places identifier, should you need it elsewhere. You do not need it to build review_url — we give you that one ready-made.
profile_url	The profile's page on Google Maps. This is the page that identifies the business: put it behind "See all reviews", and in the sameAs of your structured data.
review_url	Where a customer writes a review. An action, not an identity — so it belongs on a button, never in sameAs.
rating	Google's own average and count, over every review the profile has ever had.
reviews_synced_at	When we last mirrored the reviews. Null until the first mirror runs.
published	Whether Google is still showing this profile. When false, it has been removed from Search and Maps: profile_url and review_url no longer lead anywhere, and the rating is frozen at whatever it was. Hide the widget rather than showing figures that stopped being true.
unpublished_since	When Google stopped showing it, which is the date the rating above stopped moving. Null while the profile is published.

The three Google links are null until Google indexes the profile. Hide the button rather than linking nowhere.