What it Checks
Google's review form opens from a link built on the business's Place ID: https://search.google.com/local/writereview?placeid=…. The generator takes a list of businesses, finds the Place ID of each one and builds that link, plus a link to the business's existing reviews and to its place on Google Maps.
When you don't know a Place ID, the server looks it up with Google's Places API (text search on the name and address) and shows the business it matched, so you can check it is the right one before you share the link.
Run a Test
- Enter one business per line as comma-separated values: name, street, city, state, zip code and, optionally, the Place ID. For example
Blue Bottle Coffee, 66 Mint St, San Francisco, CA, 94103. - Add the Place ID as the sixth value for any business you already know it for. It is used as given and skips the lookup. A link that contains a Place ID (an existing review link, or a Maps link with
place_id:orquery_place_id=) works too, and so does a line holding only a Place ID. - Press Generate links. The result opens with the count: 3 review links ready., or how many could not be made.
Options
There are no settings beyond the list itself. Each line is read as CSV: wrap a value that contains a comma in double quotes, as in "Smith, Jones & Co", "10 High St, Suite 2", London, , SW1A 1AA (spaces after the commas are fine). A header row starting with Name or Business, as spreadsheets export it, is skipped. Values after the sixth are ignored, and the row says so.
| Position | Value |
|---|---|
| 1 | Business name, as it appears on Google. |
| 2 to 5 | Street, city, state or region, zip code. Empty values are skipped. |
| 6 | Place ID (optional), such as ChIJN1t_tDeuEmsRUsoyG83frY4. Google's Place ID Finder, linked under the input, finds one by hand. |
Reading the Result
- Place IDs: how many came from your input and how many were looked up with the Places API (or that lookups are off when the server has no API key).
- Missing: businesses that ended without a Place ID, either because no Google Business Profile matched or because no ID was given and lookups are off. The row says which.
- Review links: one row per business with its Place ID and the write-a-review link, with a copy button. Open a row to see the business the lookup matched (name and address on Google), the link to all its reviews and its Google Maps link.
- The table can be searched, sorted and exported as CSV or Excel.
Good to Know
- Lookups need
GOOGLE_PLACES_API_KEYon the server, with the Places API (New) enabled. Without it, the tool says so above the input, and every line needs its Place ID; the others get a Google Maps search link to find the business. If the key is refused (invalid, API not enabled, no billing, quota used up), lookups stop at the first refusal and the verdict gives Google's reason. - Lines after the 200th are not read, and the verdict counts them. Lookups run five at a time.
- A row without a Place ID still gets a Google Maps link: a search for its name and address.
API
POST /api/review-link
Send the list as one string in locations, one business per line, in the same format as the tool. The response says whether lookups were available (lookup), why they stopped (lookupError), how many lines were beyond the limit (skipped), and gives one row per line: source is input, lookup or empty, and note explains a missing Place ID.
curl -X POST https://plumb.reacthive.dev/api/review-link \
-H "content-type: application/json" \
-d '{
"locations": "Acme Dental, 1 Main St, Austin, TX, 78701, ChIJN1t_tDeuEmsRUsoyG83frY4
Blue Bottle Coffee, 66 Mint St, San Francisco, CA, 94103"
}'{
"lookup": false,
"lookupError": null,
"skipped": 0,
"rows": [
{
"name": "Acme Dental",
"address": "1 Main St, Austin, TX, 78701",
"placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4",
"source": "input",
"foundName": "",
"foundAddress": "",
"reviewLink": "https://search.google.com/local/writereview?placeid=ChIJN1t_tDeuEmsRUsoyG83frY4",
"reviewsLink": "https://search.google.com/local/reviews?placeid=ChIJN1t_tDeuEmsRUsoyG83frY4",
"mapsLink": "https://www.google.com/maps/place/?q=place_id:ChIJN1t_tDeuEmsRUsoyG83frY4",
"note": ""
},
{
"name": "Blue Bottle Coffee",
"address": "66 Mint St, San Francisco, CA, 94103",
"placeId": "",
"source": "",
"foundName": "",
"foundAddress": "",
"reviewLink": "",
"reviewsLink": "",
"mapsLink": "https://www.google.com/maps/search/?api=1&query=Blue%20Bottle%20Coffee%2C%2066%20Mint%20St%2C%20San%20Francisco%2C%20CA%2C%2094103",
"note": "No Place ID: add it as the 6th value (find it with the Place ID Finder or the Maps search link)."
}
]
}With a key, a looked-up row has source: "lookup" and the matched foundName and foundAddress.