Find Offers

GET https://api.hyperpublic.com/api/v1/offers


Hyperpublic has been acquired by Groupon! Please read our announcement.


Locally relevant offers are far more engaging than general ads. Show your users local deals and events. Earn money when they click through.

Commonly Used Parameters

Param Example Notes
q q=mixology Applies to title and description fields.
type type=deal To return only daily deals, set type=deal. Also accepts event.
lat, lon lat=40.74&lon=-74.00
radius radius=1.5&lat=40.74&lon=-74.00 Default is 2. Units are km. Requires lat and lon.
price_min price_min=10
price_max price_max=75
expiration_date expiration_date=2011-11-07 Format is YYYY-MM-DD. Granularity is 24 hours. Supersedes expiration_date_min and _max. For events, the expiration_date field is the date of the event.
expiration_date_min expiration_date_min=2011-11-07
expiration_date_max expiration_date_max=2011-11-07
limit limit=40 Default is 10. Max is 200. Supersedes page and page_size.

Other Supported Parameters

Param Example Notes
title title=bartending
price price=39
status status=all Default is active. Also accepts expired or all.
source source=buywithme Currently accepts groupon, livingsocial, buywithme, kgbdeals, seatgeek, and eventbrite.
source_id source_id=nyc-10337 Search by source-specific offer id.
page, page_size page=2&page_size=20

https://api.hyperpublic.com/api/v1/offers?lat=40.74&lon=-74.00&q=mixology&status=all&type=deal&client_id=8UufhI6bCKQXKMBn7AUWO67Yq6C8RkfD0BGouTke&client_secret=zdoROY5XRN0clIWsEJyKzHedSK4irYee8jpnOXaP