Management Stores API

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.

Getting all stores around a latitude/longitude

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.

GEThttp://management.kouponmedia.com/v2/stores/location

Query Parameters

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.

Example Response

    
{
	"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   
             }   
        ...
    ]
}