Subway

Search Subway stores near a coordinate or address

Returns Subway stores nearest first to a coordinate or a free-text address/city/ZIP, with live open/closed status, payment methods, catering link, and feature flags. This is the proximity search GET /subway/sitemap cannot do directly -- the sitemap enumerates the whole world for bulk scraping, this answers "what is near this point" with distance and live attributes the sitemap/store locator does not carry. Each store's store_id is the same value GET /subway/menu takes, and can be passed back here as store_id to re-read one store's live attributes directly.

get/subway/nearby

Request

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

Query parameters

latitudenumber

Search center latitude. Set together with longitude, or set query or store_id instead -- exactly one search mode.

longitudenumber

Search center longitude.

querystring

Free-text address, city or ZIP to search near. Alternative to latitude/longitude and store_id.

store_idstring

Look up one store directly by its store_id, from GET /subway/store or a prior /subway/nearby result. Alternative to latitude/longitude and query.

limitinteger

Maximum stores to return, 1-20 (default 10)

offsetstring

Opaque pagination cursor from a previous response's next_offset

featuresstring

Comma-separated. Restricts results to stores with ALL listed features. Allowed values: HAS_BREAKFAST, IS_REMOTEORDER_ACCEPTED, HAS_HALAL, HAS_DRIVETHROUGH, HAS_CATERING, HAS_CURBSIDE, IS_OPERATING.

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": {
    "stores": [
      {
        "address": {
          "city": "New York",
          "country": "US",
          "postal_code": "10119",
          "region": "NY",
          "street": "1 Penn Plaza"
        },
        "hours": [
          {
            "closes": "23:00",
            "day_of_week": "Monday",
            "opens": "09:00",
            "segments": [
              {
                "closes": "23:00",
                "opens": "09:00"
              }
            ]
          }
        ]
      }
    ]
  }
}

Changes

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