Find Places
GET https://api.hyperpublic.com/api/v1/places
Hyperpublic has been acquired by Groupon! Please read our announcement.
The places endpoint allows you to search for local businesses, restaurants, points of interest, landmarks and more. You can query using the below parameters, and you’ll get back rich places data in JSON format.
Hyperpublic Places+ currently covers places in the top 50+ US cities. New cities are being added frequently. For a list of the cities covered click here.
Commonly Used Parameters
| Param | Example | Notes |
q |
q=bar%20pool |
Free text. |
lat, lon |
lat=43&lon=-74 |
|
radius |
radius=5 |
Default is 2. Units are km. Requires lat and lon. |
location |
location=Chicago,%20IL |
Accepts an address, or address fragments: city, zip, etc. |
phone_number |
phone_number=2122292217 |
Accepts a phone number, regardless of formatting. |
postal_code |
postal_code=10014 |
|
category |
category=Coffee category=4e28ae8f643bce00040000ab |
Show places within this category subtree. Pass a category’s id for exact match. See Categories endpoint. |
limit |
limit=20 |
Default is 10. Max is 50. |
Other Supported Parameters
| Param | Example | Notes |
with_photo |
with_photo=true |
Accepts true, false. |
page, page_size |
page=2&page_size=5 |