We're excited to announce the launch of Koupon Insights! Download the First-Annual C-Store Insights Report Now.X
Note: Every call made to the v2 API’s must be made via the signed URL process. Any request without a valid signature will be rejected. Note the domain for this call is management.kouponmedia.com and not consumer.kouponmedia.com.
This method is used to retrieve all nearby stores within a given radius for a users’ location. This method will NOT scope the response to only show stores where certain offers are valid for.
In order to show all nearby stores within a given radius for a specific offer, the developer must make a call to GET /<consumer_identity>/offers and pass in the users’ current latitude/longitude. In that response will be a key named validAtStores which contains an array of store_id’s. These store_id’s are the same values that are returned in the [Stores][id] response below. So the developer would show only the store id’s that showed up in the validAtStores.
This method does not allow a consumer_identity.
Parameter | Required/Optional | Description |
---|---|---|
lat |
required | Latitude of location, in degrees, to search for stores near. |
lon |
required | Latitude of location, in degrees, to search for stores near. |
radius |
required | Radius, in miles, around the given lat/lon to search for nearby stores. Can be specified with fractional value (e.g. “2.5”). |
limit |
optional | A limit to the number of nearby stores to return within the radius. Optional; a negative value indicates no limit, a value of 0 will default to 20. |
{
"code": "200",
"message": "success",
"version": "2.0",
"Stores": [
{ "id" : "23432",
"name" : "Plano Texas Store #1244",
"address" : "7460 Warren Pkwy",
"city" : "Plano",
"state" : "TX",
"zip" : "75034",
"lat" : -93.543434,
"lon" : 34.234234,
"distance" : 3.242343
}
...
]
}