---
title: "Find Burger King restaurants near a location"
method: GET
path: "/burgerking/locations"
tags: ["Burger King"]
---

# Find Burger King restaurants near a location

`GET /burgerking/locations`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/burgerking/locations`
- Auth: API key in header `x-api-key`

Returns Burger King restaurants near a latitude/longitude. Each restaurant carries its internal id and numeric store id (the value /burgerking/menu and /burgerking/availability take), full address with coordinates, phone, the operating franchise group, amenity flags (breakfast, delivery, drive-thru, playground, takeout, wifi, halal, dark kitchen) and the full published week of hours for dining room, drive-thru, delivery and curbside separately. A coordinate with no nearby Burger King returns an empty list rather than an error. Setting include_availability=true additionally returns each restaurant's live per-channel open/closed status in one call, the same shape /burgerking/availability returns -- note that path is capped at a fixed page (up to 20 restaurants) rather than honoring max_results beyond that. Setting delivery_only=true instead restricts results to restaurants that Burger King's own delivery service actually considers deliverable to this coordinate -- a genuine delivery-zone match, not the same set as filtering has_delivery=true. include_availability and delivery_only cannot be combined.

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `radius` integer
- `max_results` integer
- `market` string
- `include_availability` boolean
- `delivery_only` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BurgerkingLocationsResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` BurgerkingLocationsResponse
    - `count` integer
    - `fetched_at` string
    - `has_more` boolean
    - `market` string: Market is the RBI region this query searched -- see LocationsOption's market field.
    - `restaurants` BurgerkingRestaurant[]
      - `address` string
      - `address2` string
      - `availability` BurgerkingServiceModeAvailability[]: Availability is this restaurant's live per-channel open/closed status, present only when the request set include_availability=true. See AvailabilityResponse.ServiceModes for the same shape's field meanings.
        - `closes_at` string
        - `is_open_24_hours` boolean
        - `is_open_now` boolean: IsOpenNow is true when the upstream reports this channel as currently taking orders.
        - `mode` string: Mode is one of `curbside`, `delivery`, `drive_thru`, `eat_in`, `mobile_order_drive_thru`, `takeout`.
        - `next_closes_at` string
        - `next_opens_at` string
        - `opens_at` string: OpensAt/ClosesAt are this channel's current open window, when IsOpenNow is true. NextOpensAt/NextClosesAt are the following window's start/end. All four are RFC3339 timestamps in the restaurant's own local timezone; a nil OpensAt/ClosesAt with a nil NextOpensAt/NextClosesAt too means this restaurant does not offer the channel at all, not merely that it is closed right now.
      - `city` string
      - `country` string
      - `has_breakfast` boolean
      - `has_delivery` boolean
      - `has_drive_thru` boolean
      - `has_playground` boolean
      - `has_takeout` boolean
      - `has_wifi` boolean
      - `hours` BurgerkingRestaurantHours
        - `curbside` BurgerkingDayHours[]
          - `close` string
          - `day` string
          - `open` string
        - `delivery` BurgerkingDayHours[]
          - `close` string
          - `day` string
          - `open` string
        - `dining_room` BurgerkingDayHours[]
          - `close` string
          - `day` string
          - `open` string
        - `drive_thru` BurgerkingDayHours[]
          - `close` string
          - `day` string
          - `open` string
      - `id` string
      - `is_dark_kitchen` boolean
      - `is_halal` boolean
      - `latitude` number
      - `longitude` number
      - `name` string
      - `operator` string: Operator is the franchise group operating this location, when RBI publishes one.
      - `phone` string
      - `postal_code` string
      - `state` string
      - `store_id` string
      - `website_url` string
    - `source_url` string
    - `total_count` integer: TotalCount is how many restaurants matched upstream; it can exceed Count when more results exist than max_results asked for.
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)