---
title: "Find KFC restaurants near a location"
method: GET
path: "/kfc/nearby"
tags: ["KFC"]
---

# Find KFC restaurants near a location

`GET /kfc/nearby`

## Request

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

Returns KFC restaurants near a latitude/longitude, nearest first. A coordinate with no nearby KFC returns an empty list rather than an error. Each restaurant carries its store number, full address with coordinates, phone, whether it currently accepts online orders, its timezone, and its distance from the search point in miles. occasion restricts results to restaurants that offer a given order channel (e.g. only drive-thru locations).

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `radius_miles` number
- `occasion` 'DELIVERY' | 'CARRYOUT' | 'DINE_IN' | 'DRIVE_THRU' | 'CATERING_CARRYOUT'
- `max_results` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- KfcNearbyResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` KfcNearbyResponse
    - `count` integer
    - `fetched_at` string
    - `has_more` boolean
    - `source_url` string
    - `stores` KfcNearbyStore[]
      - `accepting_online_orders` boolean
      - `address` KfcAddress
        - `address1` string
        - `address2` string
        - `city` string
        - `country_code` string
        - `latitude` number
        - `longitude` number
        - `phone` string
        - `postal_code` string
        - `state` string
      - `archived` boolean
      - `distance_miles` number
      - `name` string
      - `store_number` string
      - `timezone` string
  - `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)