Store locator and footprint mapping
Jimmy John'sエンドポイントを使えば、「Store locator and footprint mapping」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Turn Jimmy John's public store and menu data into structured JSON — a sitemap-declared index of 9,700+ store URLs across three page variants per restaurant, coordinate proximity search against Jimmy John's own Olo-backed ordering API, per-store detail, each restaurant's full menu as a category tree, and every product's customization tree down to per-ingredient extra/regular/light/none choices. Credential-free.
Enumerate Jimmy John's 9,700+ store-URL index, find restaurants by coordinate, and get store detail plus full menus and customization trees as JSON.
エンドポイントファミリー
5
ドキュメント化されたパラメータ
16
サンプル数
5
ライブカタログスナップショット
稼働エンドポイント
5
メソッド
GET
必須パラメータ
10
スキーマ参照
5
{
"platform": "Jimmy John's",
"endpoint": "jimmy-johns-nearby",
"method": "GET",
"path": "/jimmy-johns/nearby",
"auth": "apiKey"
}ユースケース
Enumerate Jimmy John's 9,700+ store-URL index, find restaurants by coordinate, and get store detail plus full menus and customization trees as JSON.
Jimmy John'sエンドポイントを使えば、「Store locator and footprint mapping」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Jimmy John'sエンドポイントを使えば、「Menu and customization monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Jimmy John'sエンドポイントを使えば、「Local retail presence monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のJimmy John'sエンドポイントカタログから取得しています（エンドポイント5件、ドキュメント化されたリクエストパラメータ16個、公開レスポンススキーマ5件）。DocsとPlaygroundが参照しているカタログと同じものです。
Jimmy John'sのエンドポイントは5件、5つのリクエストファミリーに分類されています（Menu、Modifiers、Nearbyほか2件）。
これらのJimmy John'sエンドポイントには16個のリクエストパラメータがドキュメント化されており、うち10個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
5件のJimmy John'sエンドポイントのうち5件が実際のサンプルレスポンスを、5件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Jimmy John'sのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Jimmy John'sのエンドポイントは5個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/jimmy-johns/menu
/jimmy-johns/modifiers
/jimmy-johns/nearby
/jimmy-johns/sitemap
/jimmy-johns/store
エンドポイントカタログ
/jimmy-johns/nearbyReturns Jimmy John's restaurants within a radius of a coordinate, nearest first, using Jimmy John's own Olo-backed ordering API (a separate host from the locator this family's sitemap and store endpoints read). Each result carries restaurant_id -- pass it to GET /jimmy-johns/menu for that restaurant's full menu. The upstream's own radius parameter does not narrow its result set, so distance filtering and sorting happen here.
MCPツール jimmy_johns_nearby
/jimmy-johns/sitemapReturns one page of Jimmy John's sitemap-declared store index -- 9,700+ URLs at time of writing. Jimmy John's publishes three page variants per store (sandwiches, delivery, catering) and all three appear in the sitemap, so each entry carries a kind and the store number they share; filter with the kind parameter to enumerate one variant per restaurant. `sandwiches` is the canonical variant. A page past the end returns an empty list rather than an error, so a caller can walk to exhaustion.
MCPツール jimmy_johns_sitemap
/jimmy-johns/storeReturns one Jimmy John's store: name, postal address, phone, coordinates, cuisine description and the published week of opening hours. Store paths come from GET /jimmy-johns/sitemap. Note Jimmy John's main site is behind a bot challenge that serves a page with HTTP 200, so this family reads the separate locator subdomain instead. For menu data, see GET /jimmy-johns/nearby and GET /jimmy-johns/menu, which read a separate ordering API.
MCPツール jimmy_johns_store
/jimmy-johns/menuReturns one Jimmy John's restaurant's full menu as a category tree: every category and its products, with name, description, calorie range, base cost and image. restaurant_id comes from GET /jimmy-johns/nearby. Many sandwiches price entirely through a size selection rather than a base cost, so cost is commonly 0 for those items -- see GET /jimmy-johns/modifiers for the real per-size price.
レスポンスに関する注記
- Many sandwiches price entirely through a size selection rather than a base cost, so `cost` is `0` for those items — see `/jimmy-johns/modifiers` for the real per-size price. Combos and flat-priced items (cookies, drinks) carry a real `cost`. - `base_calories` and `max_calories` bound the calorie range across an item's size/customization options and arrive as strings (e.g. Jimmy John's own site renders `370-650` with a separator), so they are not coerced to a number here. - `chain_product_id` identifies an item across every Jimmy John's restaurant; `product_id` is specific to this restaurant's own menu. - A `restaurant_id` with no active menu returns a 404.
MCPツール jimmy_johns_menu
/jimmy-johns/modifiersReturns one menu product's full customization tree: size, bread, and per-ingredient choices (extra/regular/light/none), each with its real price and calorie delta. Groups nest -- picking a size choice can reveal a bread group, which can reveal one group per ingredient -- so a size step, a bread step, and every "Customize Sandwich" ingredient all live in one recursive tree. product_id comes from GET /jimmy-johns/menu.
レスポンスに関する注記
- Groups nest recursively through a choice's `groups`: picking a size choice can reveal a bread group, and picking "Customize Sandwich" reveals one group per ingredient (bread, ham, cheese, lettuce, etc.). A sandwich's real per-size price lives here — under "Choose Your Size" — not in `/jimmy-johns/menu`'s `cost` field. - `cost` is a price delta relative to the parent choice, not an absolute price. Most ingredient choices are free (the included default); an "Xtra" choice carries a positive cost, and a "No" choice is usually `0` with a negative `base_calories`. - `base_calories` can be negative for a "light"/"no" ingredient choice, reflecting the calorie reduction from the default. - `min_selects`/`max_selects` are omitted when the upstream places no explicit limit beyond `mandatory`.
MCPツール jimmy_johns_modifiers
関連API
Marketplaces & Retail
Research new, used, and vintage instruments across Reverb listings, seller shops, and the Price Guide. Keep current asking prices separate from historical sales, and preserve model, finish, year, condition, and currency when comparing gear.
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Jimmy John'sのスクレイピング方法
Crawlora's Jimmy John's endpoints return normalized public Jimmy John's data as JSON with one API key — no Jimmy John's account required. Two different upstreams back this family: the public locator (sitemap/store) and Jimmy John's own Olo-backed ordering API (nearby/menu/modifiers).
Call /jimmy-johns/sitemap to page through Jimmy John's sitemap-declared store index — 9,700+ URLs at time of writing. Jimmy John's publishes three page variants per store and all three appear, so each entry carries a kind plus the store_number they share; filter on kind to get one row per restaurant (sandwiches is the canonical variant).
Pass a latitude and longitude to /jimmy-johns/nearby for restaurants nearest first, read from Jimmy John's own Olo-backed ordering API rather than the locator. Each result carries a restaurant_id — the id /jimmy-johns/menu needs.
Pass a store path from /jimmy-johns/sitemap to /jimmy-johns/store for that location's published detail.
Pass a restaurant_id from /jimmy-johns/nearby to /jimmy-johns/menu for that restaurant's full menu as a category tree, then a product_id from it to /jimmy-johns/modifiers for that product's complete customization tree — size, bread, and per-ingredient extra/regular/light/none choices.
FAQ
Call /jimmy-johns/nearby with a coordinate or /jimmy-johns/sitemap to enumerate the store index, /jimmy-johns/store for one store's detail, then /jimmy-johns/menu and /jimmy-johns/modifiers for a restaurant's menu and customization options — all return structured JSON with one API key.
Jimmy John's publishes three page variants per restaurant and all three appear in its own sitemap. Each /jimmy-johns/sitemap entry carries a kind and the store_number the variants share — filter on kind to enumerate one row per restaurant; sandwiches is the canonical variant.
restaurant_id, which comes from /jimmy-johns/nearby (the Olo-backed ordering API), not the store_number or path the sitemap and store endpoints use — those read the public locator, a different upstream.
Yes — /jimmy-johns/modifiers returns one product's full customization tree, including size, bread, and each ingredient's extra/regular/light/none choices.