---
title: "Find Papa John's stores near a coordinate"
method: GET
path: "/papajohns/nearby"
tags: ["Papa John's"]
---

# Find Papa John's stores near a coordinate

`GET /papajohns/nearby`

## Request

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

Returns Papa John's stores within a radius of a latitude/longitude, ordered nearest first, with distance, address, phone, hours, timezone, price range, fulfillment services, payment options, and ordering link. The response includes total_in_radius and offset paging. A coordinate with no nearby stores returns an empty list.

## Query parameters

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

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PapajohnsNearbyResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` PapajohnsNearbyResponse
    - `count` integer
    - `fetched_at` string
    - `radius` integer
    - `source_url` string
    - `stores` PapajohnsNearbyStore[]
      - `address` PapajohnsStoreAddress
        - `city` string
        - `country` string
        - `line1` string
        - `postal_code` string
        - `region` string
      - `delivery_hours` PapajohnsStoreHours[]: DeliveryHours and TakeoutHours are Papa John's own per-channel hours, published separately from Hours and commonly later-closing.
        - `closed` boolean: Closed is true when Papa John's publishes the day with no open interval.
        - `closes` string
        - `day_of_week` string
        - `opens` string
      - `distance_kilometers` number
      - `distance_miles` number: DistanceMiles and DistanceKilometers are measured from the requested coordinate.
      - `hours` PapajohnsStoreHours[]: Hours is the store's general published week of hours.
        - `closed` boolean: Closed is true when Papa John's publishes the day with no open interval.
        - `closes` string
        - `day_of_week` string
        - `opens` string
      - `latitude` number
      - `longitude` number
      - `name` string
      - `order_url` string: OrderURL is Papa John's own carryout ordering deep link for this store.
      - `path` string: Path is the /papajohns/store path for this store, so a caller can go straight to the detail endpoint.
      - `payment_options` string[]: PaymentOptions are the payment methods this store accepts, e.g. APPLEPAY, CASH, VISA.
      - `phone_number` string: PhoneNumber is Papa John's own E.164-shaped mainPhone, e.g. "+12136172727" -- deliberately left as published rather than reformatted, since geosearch and the store page publish phone numbers in different shapes (mainPhone here vs. a display-formatted string on /papajohns/store).
      - `pickup_and_delivery_services` string[]: PickupAndDeliveryServices are the fulfillment flags Papa John's publishes for this store, e.g. IN_STORE_PICKUP, SAME_DAY_DELIVERY.
      - `price_range` string: PriceRange is Papa John's own relative price tier, e.g. ONE, TWO.
      - `store_id` string
      - `takeout_hours` PapajohnsStoreHours[]
        - `closed` boolean: Closed is true when Papa John's publishes the day with no open interval.
        - `closes` string
        - `day_of_week` string
        - `opens` string
      - `timezone` string
    - `total_in_radius` integer: TotalInRadius is how many stores fall inside the radius overall, which is usually far more than one page. Use it with `offset` to page.
  - `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)