Groupon API Documentation

Search this site

Divisions API

The Divisions API is responsibile for returning information on divisions supported by Groupon, where a Division is defined as a logical grouping (geographic or non-geographic of deals that may appear on the Groupon site.  Currently these divisions represent discrete metropolitan areas, but the API may at some point in the future provide divisions which do not represent specific cities or towns, but may span larger geographic areas or time zones.


Retrieving A List of All Divisions

URL:
    http://www.groupon.com/api/v1/divisions

Supported Formats:
    JSON / XML


Description:
    Returns a list of divisions - cities where Groupon is live.


Query Parameters:
    none

Sample Response (JSON)
{
    "status": 
    {
        "code": 0,
        "message": "OK"
    },
     "divisions": 
    [
        {
            "name": "Atlanta",
             "location": 
            {
                 "longitude": -84.3897,
                 "timezone": "Eastern Time (US \u0026 Canada)",
                 "timezone_offset_gmt": -18000,
                 "latitude": 33.7545
            },
             "id": "atlanta"
        },
         
        {
            "name": "Austin",
             "location": 
            {
                 "longitude": -97.7452,
                 "timezone": "Central Time (US \u0026 Canada)",
                 "timezone_offset_gmt": -21600,
                 "latitude": 30.2687
            },
             "id": "austin"
        },
         
        {
            "name": "Baltimore",
             "location": 
            {
                 "longitude": -76.6143,
                 "timezone": "Eastern Time (US \u0026 Canada)",
                 "timezone_offset_gmt": -18000,
                 "latitude": 39.2943
            },
             "id": "baltimore"
        },
         
        {
            "name": "Boston",
             "location": 
            {
                 "longitude": -71.0578,
                 "timezone": "Eastern Time (US \u0026 Canada)",
                 "timezone_offset_gmt": -18000,
                 "latitude": 42.3589
            },
             "id": "boston"
        },
         
        {
            "name": "Charlotte",
             "location": 
            {
                 "longitude": -80.8458,
                 "timezone": "Eastern Time (US \u0026 Canada)",
                 "timezone_offset_gmt": -18000,
                 "latitude": 35.2314
            },
             "id": "charlotte"
        },
         
        {
            "name": "Chicago",
             "location": 
            {
                 "longitude": -87.6243,
                 "timezone": "Central Time (US \u0026 Canada)",
                 "timezone_offset_gmt": -21600,
                 "latitude": 41.8795
            },
             "id": "chicago"
        }
    ]
}

Sample Response (XML)

<?xml version="1.0" encoding="utf-8"?>
<response code="0" message="OK">
  <divisions>
    <division>
      <id>atlanta</id>
      <name>Atlanta</name>
      <location>
        <timezone>Eastern Time (US &amp; Canada)</timezone>
        <timezone_offset_gmt>-18000</timezone_offset_gmt>
        <latitude>33.7545</latitude>
        <longitude>-84.3897</longitude>
      </location>
    </division>
    <division>
      <id>austin</id>
      <name>Austin</name>
      <location>
        <timezone>Central Time (US &amp; Canada)</timezone>
        <timezone_offset_gmt>-21600</timezone_offset_gmt>
        <latitude>30.2687</latitude>
        <longitude>-97.7452</longitude>
      </location>
    </division>
    <division>
      <id>baltimore</id>
      <name>Baltimore</name>
      <location>
        <timezone>Eastern Time (US &amp; Canada)</timezone>
        <timezone_offset_gmt>-18000</timezone_offset_gmt>
        <latitude>39.2943</latitude>
        <longitude>-76.6143</longitude>
      </location>
    </division>
    <division>
      <id>boston</id>
      <name>Boston</name>
      <location>
        <timezone>Eastern Time (US &amp; Canada)</timezone>
        <timezone_offset_gmt>-18000</timezone_offset_gmt>
        <latitude>42.3589</latitude>
        <longitude>-71.0578</longitude>
      </location>
    </division>
    <division>
      <id>charlotte</id>
      <name>Charlotte</name>
      <location>
        <timezone>Eastern Time (US &amp; Canada)</timezone>
        <timezone_offset_gmt>-18000</timezone_offset_gmt>
        <latitude>35.2314</latitude>
        <longitude>-80.8458</longitude>
      </location>
    </division>
    <division>
      <id>chicago</id>
      <name>Chicago</name>
      <location>
        <timezone>Central Time (US &amp; Canada)</timezone>
        <timezone_offset_gmt>-21600</timezone_offset_gmt>
        <latitude>41.8795</latitude>
        <longitude>-87.6243</longitude>
      </location>
    </division>
  </divisions>
</response>