Customer reviews of a Groupon deal and its merchant: rating, text, date, option bought, helpful count, reviewer (first name, review and rating counts, badges), photos and merchant replies, with the deal's overall rating, rating count and review topics. Filter by star rating or topic; sort by most recent or most helpful. Pass a deal slug or link, or q (with location or lat/lng) to use the first current deal for a search. Pass next_page back as page; null on the last page.
Every response includes credits_used: the credits this call cost.
Parameters
name
type
description
slug
string
Deal slug, the groupon.com/deals/<slug> part.
url
string
Deal link (instead of slug).
q
string
Uses the first current deal for this search (instead of slug). Example: architecture boat tour
location
string
With q: city slug to search in (default chicago); or pass lat and lng. Example: chicago
lat
number
With q: latitude to search around.
lng
number
With q: longitude to search around.
sort
recent | helpful
Order of the reviews. Default recent.
rating
string
Only these star ratings, e.g. 1 or 1,2.
topic
string
Only reviews about one topic from the response's topics list (e.g. guide, staff, price).
import os, requests
res = requests.get(
"https://api.api.sh/groupon/v1/reviews",
params={},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json()
const url = new URL("https://api.api.sh/groupon/v1/reviews");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();
Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.