Public reviews API
Read a location's or your whole organisation's public reviews, average rating and disclosure as JSON, with no key, for your own review section or app.
Reference4 min read
The public reviews API is what the review widget reads. Call it yourself when you want your own markup, such as review cards in your shop's design or reviews in an app. It is in every plan.
GET https://app.bifrostorbit.com/presence/api/public/{business}/reviews{business} is the Short name under Settings, such as northwilds.
Key: none. The answer holds only what review sites show publicly anyway.
Websites: when an Admin lists websites under Settings, Your website, a browser on any other website gets 403. Calls from a server, which send no Origin header, always work.
Query parameters
locationnorthwilds-oslogrouplocation is givensourcesgoogle, facebook, trustpilot, import, sandbox. Others are ignoredmin2 to 5. Reviews that only say "recommends" count as 5, "doesn't recommend" as 1limit1 to 3010A location's slug comes from its name: Northwilds Oslo becomes northwilds-oslo. It changes when the location is renamed, so check your pages after renaming one.
Reviews from Tripadvisor, Apple Business Connect and Bing Places, and private feedback, never come through this API.
The answer
{ "data": { "business": "Northwilds Oslo", "average": 4.6, "total": 131, "reviews": [ { "id": "6aee50892701b762d4918729", "source": "google", "sourceName": "Google", "rating": 5, "recommends": null, "text": "Great advice on boots for the Lofoten trip.", "author": "Ingrid B.", "date": "2026-11-03T16:00:00.000Z", "url": "https://www.google.com/maps/…", "location": "Northwilds Oslo", "reply": { "text": "Thank you, Ingrid. Enjoy Lofoten.", "date": "2026-11-04T08:12:00.000Z" } } ], "disclosure": "Reviews from Google, Facebook, Trustpilot and Imported, the newest first, none left out. 1 of 131 shown. Published as written by customers; we reply but never edit them.", "howUrl": "https://app.bifrostorbit.com/presence/l/northwilds/northwilds-oslo" }}businessaveragenull when there are none. min doesn't change ittotallocation, group and sources, before min and limitreviewsreviews[].source, sourceNamereviews[].ratingnull on sites that only ask for a recommendation, such as Facebookreviews[].recommendstrue or false on those sites, otherwise nullreviews[].textreviews[].authorIngrid B.reviews[].datereviews[].urlnullreviews[].locationreviews[].replynull. Drafts and replies waiting for approval never showdisclosurehowUrlnull. Link to itRules in the EU and the UK ask anyone who shows reviews to say how they were collected and whether any are left out. Showing disclosure and linking to howUrl does both. See Show reviews on your website.
Caching and limits
Answers are cached for 60 seconds in browsers and 5 minutes in shared caches, and can be served stale for an hour while they refresh (Cache-Control: public, max-age=60, s-maxage=300, stale-while-revalidate=3600). A new review or reply shows within about 5 minutes.
Each address can make 120 requests a minute. After that the API answers 429 with Retry-After: 60. A website with many visitors should cache on its own server, or use the widget, which browsers cache.
Errors
Errors have the shape { "error": { "code": "…", "message": "…" } }.
404not_foundlocation or group matches no location403forbidden402subscription_inactive429rate_limitedSee Troubleshooting for what to do about each one.
Stars in search
The API returns data, not markup. Before you add review structured data to a page, read Review stars and structured data: for reviews of your own business, Google shows no stars, whatever the markup.
Was this page helpful?