Dunkin

Find Dunkin stores near a coordinate, nearest first

Returns Dunkin restaurants within a radius of a latitude/longitude, ordered nearest first, each with its distance in miles and kilometres, full address, phone, coordinates, the published week of hours, whether it's permanently closed, amenities, payment methods, pickup/delivery service types, which third-party delivery platforms are active, its Google Place id, timezone, and website/menu/order URLs. This is the proximity search the directory browse cannot do -- GET /dunkin/directory walks a state to city to store tree, which requires knowing the administrative path in advance. Each result carries the store id as path, which GET /dunkin/store also takes, so the two chain directly. total_in_radius reports how many stores fall inside the radius overall, which is usually far more than one page; use offset to walk it. A coordinate with no Dunkin nearby returns an empty list rather than an error.

get/dunkin/nearby

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/dunkin/nearby
  • Auth: API key in header x-api-key

Query parameters

latitudenumber required

Search center latitude

longitudenumber required

Search center longitude

radiusinteger

Search radius in miles, 1-100 (default 25)

limitinteger

Maximum stores to return, 1-50 (default 10)

offsetinteger

Result offset for paging through total_in_radius (default 0)

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "count": 10,
    "radius": 25,
    "stores": [
      {
        "address": {
          "city": "New York",
          "country": "US",
          "line1": "250 Broadway",
          "line2": "Park Pl Between Church & B'Way",
          "postal_code": "10007",
          "region": "NY"
        },
        "distance_kilometers": 0.18,
        "distance_miles": 0.11,
        "faq": [
          {
            "answer": "Dunkin' is open Monday to Friday from 5:30 AM to 6:00 PM, and on Saturday and Sunday from 6:00 AM to 4:00 PM.",
            "question": "What are the operating hours of Dunkin' at 250 Broadway, New York, NY?"
          }
        ],
        "hours": [
          {
            "closes": "18:00",
            "day_of_week": "Monday",
            "opens": "05:30"
          }
        ],
        "latitude": 40.712975,
        "longitude": -74.007829,
        "name": "Dunkin'",
        "phone_number": "+12127320406",
        "photos": [
          {
            "description": "Cold Brew Dunkin'",
            "height": 571,
            "url": "https://a.mktgcdn.com/p/QcZOFKXgjA12APmvcuFAD3tS2mDRp6fwK3R8kE0O7E0/570x571.png",
            "width": 570
          }
        ],
        "store_id": "307107",
        "timezone": "America/New_York"
      }
    ],
    "total_in_radius": 754
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.