---
title: "Find Sonic Drive-In restaurants near a coordinate"
method: GET
path: "/sonic/nearby"
tags: ["Sonic"]
---

# Find Sonic Drive-In restaurants near a coordinate

`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`

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.

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `radius` integer
- `limit` integer
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SonicNearbyResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SonicNearbyResponse
    - `fetched_at` string
    - `is_last_page` boolean
    - `latitude` number
    - `limit` integer
    - `longitude` number
    - `page` integer
    - `radius_miles` integer
    - `returned_count` integer
    - `source_url` string
    - `stores` SonicNearbyStore[]
      - `address` SonicStoreAddress
        - `city` string
        - `country` string
        - `line1` string
        - `line2` string
        - `postal_code` string
        - `state` string
      - `amenities` string[]
      - `delivery_providers` SonicDeliveryProvider[]
        - `is_active` boolean
        - `name` string
        - `url` string
      - `display_name` string
      - `distance_miles` number
      - `has_drive_through` boolean
      - `hours` SonicStoreHours[]
        - `closes` string
        - `day_of_week` string
        - `is_24_hour` boolean
        - `opens` string
      - `is_delivery_enabled` boolean
      - `is_digitally_enabled` boolean
      - `latitude` number
      - `longitude` number
      - `phone` string
      - `service_hours` SonicStoreServiceHours[]
        - `hours` SonicStoreHours[]
          - `closes` string
          - `day_of_week` string
          - `is_24_hour` boolean
          - `opens` string
        - `is_fulfillment` boolean
        - `is_tipping_enabled` boolean
        - `type` string: Type is Sonic's own channel name, e.g. "ORDER_AHEAD", "PICKUP", "CURBSIDE_PICKUP", "STORE", "DELIVERY", "DRIVE_THROUGH".
      - `status` string
      - `store_id` string
      - `timezone` string
    - `total_pages` integer
    - `total_stores` integer
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)