Sonic

Find Sonic Drive-In restaurants near a coordinate

Returns Sonic Drive-In restaurants within a radius of a latitude/longitude, nearest first, one page at a time. Each result carries the same detail as GET /sonic/store -- address, phone, coordinates, open/closed status, amenities, weekly hours per fulfillment channel, and delivery-provider deep links -- plus distance_miles from the search centre, so ranking or mapping results needs no follow-up call per store. Use this instead of paging GET /sonic/sitemap when you know roughly where you are looking. An area with no restaurants returns an empty stores array with total_stores 0, not an error.

get/sonic/nearby

Request

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

Query parameters

latitudenumber required

Latitude of the search centre, -90 to 90

longitudenumber required

Longitude of the search centre, -180 to 180

radiusinteger

Search radius in miles, 1-100. Defaults to 25.

limitinteger

Stores per page, 1-50. Defaults to 10.

pageinteger

Zero-based page number. Defaults to 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": {
    "latitude": 35.4676,
    "limit": 10,
    "longitude": -97.5164,
    "radius_miles": 25,
    "returned_count": 10,
    "stores": [
      {
        "address": {
          "city": "Cheyenne",
          "country": "US",
          "line1": "2540 Dell Range Blvd",
          "postal_code": "82009",
          "state": "WY"
        },
        "delivery_providers": [
          {
            "name": "DoorDash"
          }
        ],
        "display_name": "2540 Dell Range Blvd, Cheyenne, WY",
        "distance_miles": 3.45,
        "hours": [
          {
            "closes": "21:45",
            "day_of_week": "MONDAY",
            "opens": "07:00"
          }
        ],
        "latitude": 41.160531,
        "longitude": -104.777659,
        "phone": "307-632-9188",
        "service_hours": [
          {
            "hours": [
              {
                "closes": "21:45",
                "day_of_week": "MONDAY",
                "opens": "07:00"
              }
            ],
            "type": "DRIVE_THROUGH"
          }
        ],
        "status": "OPEN",
        "store_id": "4521",
        "timezone": "America/Denver"
      }
    ],
    "total_pages": 2,
    "total_stores": 17
  }
}

Changes

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