Maxwell International Food API

The food API from Maxwell International — 4 operation(s) for food.

GitHub OpenAPI

Operations 4

GET /v1/food/menu Restaurant menu with prices: the dishes and drinks of one restaurant with… #
GET /v1/food/near Restaurants near me / near any location: restaurants, cafes and bars nearby… #
GET /v1/food/near-resort Where to eat at a ski resort (countries with restaurants on file at… #
GET /v1/food/venues Restaurants, cafes and bars in a ski area or mountain town of any country… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/maxwellinternational-ai:maxwellinternational-ai-food-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

maxwellinternational-ai-food-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Maxwell International Data (x402) Food API
  version: 1.0.0
  description: Machine-only pay-per-call data API over x402. Prices are per request in USDC.
  x-guidance: 'Pay-per-call data for ski trips and public records, plus x402 Doctor, which tests other x402 endpoints for you. Ski: a directory of about 6,000 ski resorts worldwide, lift-ticket prices for the resorts listed at /v1/ski/coverage, a model forecast for every resort (station readings where one of 11 European met services has a station), lift status and snow reports only at about 50 resorts with their own feed (in Poland, Slovakia, Switzerland, Liechtenstein and Friuli in Italy; only while current), insider tips, and the Trip Wizard (a free map, then one paid call per trip step). Food: restaurants around ski resorts in every country listed at /v1/food/coverage (free, with per-country counts), with opening hours, website and contacts where known. Menus and prices only where read (withMenu): in Andorra, Austria, Bulgaria, Czechia, Finland, France, Germany, Italy, Liechtenstein, Norway, Poland, Slovakia, Slovenia, Spain, Sweden and Switzerland from the restaurant’s own website or, where none is published, a delivery app; in every other country only where a delivery app (Wolt, Bolt Food, Glovo, Pyszne.pl) lists the restaurant, as restaurants’ own websites are read for menus only in those 16 countries. Public data: SEC EDGAR, government registers and legislation of 13 countries and the EU, OFAC SDN, NVD CVEs, openFDA, NOAA weather (US), ECB FX, FRED, npm, RDAP domain records, crypto market quotes, US court opinions, US patents. Paid operations are GET, except doctor.payment and llm.chat (POST with a JSON body). Call one without payment to receive HTTP 402 with a PAYMENT-REQUIRED header (x402 v2): USDC on Base (eip155:8453) or Solana, settled through the Coinbase CDP facilitator. Send the same request again with a PAYMENT-SIGNATURE header. You are charged only for a 2xx answer. Missing or ambiguous parameters get a free 400 or 409 and a request with no data on file a free 404, both with charged:false. A search that runs and finds nothing is a 2xx answer (match:false) and is charged. Most routes check parameters before asking for payment. A bare path (directory probes), ski.prices without country, gov.de legislation and open data, and a POST without the fields it needs get the 402 first; after payment a request that cannot be answered still gets a free 400 (ski.prices answers if the resort id is unique). food.menu without restaurantId is a free 404. Paid answers that can look empty: a search with no matches (match:false), an RDAP lookup of an unregistered domain (registered:false) or of a registry without RDAP (rdapAvailable:false), and gov.de legislation or open data without q or id (the index of what is cached). doctor.buy and llm.chat collect the payment before they run: doctor.buy charges for the attempt, delivered or not; if the llm.chat model fails after payment, the answer (HTTP 503, llm_failed_after_payment) says charged:true and the payment is refunded by hand. A lookup of one item that is not cached yet (CVE, accession, company number, coordinates) is usually queued: retry after retryAfterSec. Priced per request (x-payment-info mode dynamic, with min and max where there is one): doctor.buy, llm.chat, trip.bundle; the 402 quotes the exact amount. Every other product has one price. Each response carries fetchedAt or generatedAt. Forecasts refresh every 6 hours, and lift status every 15 minutes where the resort has a feed. Hand-checked lift-ticket prices were read from official price lists on Oct 7-9, 2026 (rechecks from Nov 8); the others come from a weekly crawl of the resort''s price pages or from an earlier collection (operator shops, price pages); every row has its source link and read date. Public records refresh on each source''s schedule (age per family at /health). Free status and coverage endpoints are listed at /catalog.json; terms at /terms.json. Free samples: most products have one real request you can call free to check the data first (freeSampleUrl in /catalog.json, x-free-sample here, freeSample in every 402): the same answer a buyer of that request gets.'
  contact:
    name: Maxwell International
    email: accounts@maxwellinternational.ai
    url: https://api.maxwellinternational.ai/terms.json
  termsOfService: https://api.maxwellinternational.ai/terms.json
servers:
- url: https://api.maxwellinternational.ai
tags:
- name: food
paths:
  /v1/food/menu:
    get:
      operationId: food_menu
      summary: 'Restaurant menu with prices: the dishes and drinks of one restaurant with…'
      description: 'Restaurant menu with prices: the dishes and drinks of one restaurant with prices where shown, section, portion, currency and the menu''s date, from the restaurant''s own website (only in Andorra, Austria, Bulgaria, Czechia, Finland, France, Germany, Italy, Liechtenstein, Norway, Poland, Slovakia, Slovenia, Spain, Sweden and Switzerland) or a delivery app (Wolt, Bolt Food, Glovo, Pyszne.pl; named in the answer), which in every other country is the only source of menus. Only restaurants whose menu has been read (menuItemCount > 0; ids from /v1/food/near, /near-resort or /venues); prices as printed, in the currency printed, never converted. No Google data.'
      tags:
      - food
      parameters:
      - name: restaurantId
        in: query
        required: true
        schema:
          type: string
        example: osm-node-7248743761
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/food/menu?restaurantId=osm-node-7248743761&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  restaurantId:
                    type: string
                  name:
                    type: string
                  type:
                    type: string
                  cuisine:
                    type: array
                    items:
                      type: string
                  address: {}
                  lat:
                    type: number
                  lon:
                    type: number
                  hours:
                    type: string
                  phone:
                    type: string
                  website:
                    type: string
                  currency:
                    type: string
                  menuItemCount:
                    type: integer
                  osmUrl:
                    type: string
                  country:
                    type: string
                  area:
                    type: string
                  mealPeriods:
                    type: array
                  menuSource:
                    type: object
                    properties:
                      kind:
                        type: string
                      app: {}
                      url:
                        type: string
                      menuType:
                        type: string
                      menuDate:
                        type: string
                      collectedAt:
                        type: string
                  menuItems:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        price:
                          type: number
                        currency:
                          type: string
                        category:
                          type: string
                        portion:
                          type: string
                  notice:
                    type: string
              example:
                restaurantId: osm-node-7248743761
                name: Mikulášska chata
                type: restaurant
                cuisine:
                - international
                address: null
                lat: 48.969278
                lon: 19.57526
                hours: Mo-Su 12:00-20:00
                phone: '+421918371702'
                website: https://www.mikulasskachata.sk/hotel/gastronomia/
                currency: EUR
                menuItemCount: 101
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/food/near:
    get:
      operationId: food_near
      summary: 'Restaurants near me / near any location: restaurants, cafes and bars nearby…'
      description: 'Restaurants near me / near any location: restaurants, cafes and bars nearby within a radius (default 2 km, max 10) of a latitude/longitude, nearest first, with distance, cuisine, address, and where known opening hours, phone, website and menu availability. Covers the ski areas of the countries listed at /v1/food/coverage; a point with nothing on file is a free 404. No Google data.'
      tags:
      - food
      parameters:
      - name: lat
        in: query
        required: true
        schema:
          type: number
        example: '48.9709'
      - name: lon
        in: query
        required: true
        schema:
          type: number
        example: '19.5839'
      - name: radiusKm
        in: query
        required: false
        schema:
          type: number
        example: '1.5'
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: type
        in: query
        required: false
        schema:
          type: string
        description: restaurant, cafe, bar, pub, fast_food
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/food/near?lat=48.9709&lon=19.5839&radiusKm=1.5&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  lat:
                    type: number
                  lon:
                    type: number
                  radiusKm:
                    type: number
                  total:
                    type: integer
                  count:
                    type: integer
                  restaurants:
                    type: array
                    items:
                      type: object
                      properties:
                        distanceKm:
                          type: number
                        restaurantId:
                          type: string
                        name:
                          type: string
                        type:
                          type: string
                        lat:
                          type: number
                        lon:
                          type: number
                        hours:
                          type: string
                        currency:
                          type: string
                        menuItemCount:
                          type: integer
                        osmUrl:
                          type: string
                        country:
                          type: string
                        area:
                          type: string
                  notice:
                    type: string
              example:
                lat: 48.9709
                lon: 19.5839
                radiusKm: 1.5
                total: 22
                count: 22
                restaurants:
                - distanceKm: 0.01
                  restaurantId: osm-node-7243673322
                  name: Crystal bar
                  type: bar
                  lat: 48.970943
                  lon: 19.583767
                  hours: Mo-Su 08:00-21:00
                  currency: EUR
                  menuItemCount: 0
                  osmUrl: https://www.openstreetmap.org/node/7243673322
                  country: sk
                  area: liptov-jasna
                notice: Restaurant data © OpenStreetMap contributors, ODbL 1.0 (openstreetmap.org/cop…
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/food/near-resort:
    get:
      operationId: food_near_resort
      summary: Where to eat at a ski resort (countries with restaurants on file at…
      description: 'Where to eat at a ski resort (countries with restaurants on file at /v1/food/coverage): restaurants, cafes, mountain huts and bars near the resort''s arrival point (ticket office or main lift). tier=near: within 1 km; tier=around: 1 to 15 km ($0.02 each). Nearest first, with distance, cuisine, opening hours and the full menu (dishes and prices) of each restaurant in the tier whose menu has been read. Says how many are in the other tier. No Google data.'
      tags:
      - food
      parameters:
      - name: country
        in: query
        required: true
        schema:
          type: string
        example: Austria
      - name: resort
        in: query
        required: true
        schema:
          type: string
        description: resortId from /v1/ski/inventory
        example: kitzbuehel
      - name: tier
        in: query
        required: false
        schema:
          type: string
        description: near (0-1 km) or around (1-15 km); default near
        example: near
      - name: state
        in: query
        required: false
        schema:
          type: string
        description: US only
      - name: type
        in: query
        required: false
        schema:
          type: string
        description: restaurant, cafe, bar, pub, fast_food
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/food/near-resort?country=Austria&resort=kitzbuehel&tier=near&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  resort:
                    type: object
                    properties:
                      resortId:
                        type: string
                      name:
                        type: string
                      region:
                        type: string
                      state: {}
                      operator:
                        type: string
                      officialSite:
                        type: string
                      officialBookingUrl:
                        type: string
                      priceListUrl:
                        type: string
                      currency:
                        type: string
                      lat:
                        type: number
                      lon:
                        type: number
                      location:
                        type: string
                      locationName:
                        type: string
                      country:
                        type: string
                  tier:
                    type: string
                  ringKm:
                    type: object
                    properties:
                      from:
                        type: integer
                      to:
                        type: integer
                  measuredFrom:
                    type: string
                  total:
                    type: integer
                  withMenu:
                    type: integer
                  count:
                    type: integer
                  restaurants:
                    type: array
                    items:
                      type: object
                      properties:
                        distanceKm:
                          type: number
                        restaurantId:
                          type: string
                        name:
                          type: string
                        type:
                          type: string
                        lat:
                          type: number
                        lon:
                          type: number
                        currency:
                          type: string
                        menuItemCount:
                          type: integer
                        osmUrl:
                          type: string
                        country:
                          type: string
                        area:
                          type: string
                  menus:
                    type: array
                    items:
                      type: object
                      properties:
                        restaurantId:
                          type: string
                        name:
                          type: string
                        currency:
                          type: string
                        menuDate:
                          type: string
                        collectedAt:
                          type: string
                        source:
                          type: string
                        items:
                          type: array
                          items:
                            type: object
                  otherTier:
                    type: object
                    properties:
                      tier:
                        type: string
                      ringKm:
                        type: object
                        properties:
                          from:
                            type: integer
                          to:
                            type: integer
                      restaurants:
                        type: integer
                      withMenu:
                        type: integer
                      priceUsd:
                        type: number
                      url:
                        type: string
                  notice:
                    type: string
              example:
                resort:
                  resortId: kitzbuehel
                  name: Kitzbühel / KitzSki
                  region: Kitzbüheler Alpen / Tyrol
                  state: null
                  operator: KitzSki / Bergbahn AG Kitzbühel
                  officialSite: https://www.kitzski.at/
                  officialBookingUrl: https://shop.kitzski.at/
                  priceListUrl: https://www.kitzski.at/de/tickets-gutscheine/skiticket.html
                  currency: EUR
                  lat: 47.44323
                  lon: 12.38936
                  location: main_lift_base
                tier: near
                ringKm:
                  from: 0
                  to: 1
                measuredFrom: main_lift_base
                total: 56
                withMenu: 8
                count: 56
                restaurants:
                - distanceKm: 0.01
                  restaurantId: osm-node-13485446050
                  name: Legenden Cafe
                  type: cafe
                  lat: 47.443296
                  lon: 12.38942
                  currency: EUR
                  menuItemCount: 0
                  osmUrl: https://www.openstreetmap.org/node/13485446050
                  country: at
                  area: kitzbuhel-kitzski
                menus:
                - restaurantId: osm-node-4777573622
                  name: The Londoner
                  currency: EUR
                  menuDate: '2025-01-01'
                  collectedAt: '2026-09-28T14:54:13Z'
                  source: https://thelondoner.at/wp-content/uploads/2025/11/01_speisekarte-thelondoner-…
                  items: []
                otherTier:
                  tier: around
                  ringKm:
                    from: 1
                    to: 15
                  restaurants: 313
                  withMenu: 17
                  priceUsd: 0.02
                  url: https://api.maxwellinternational.ai/v1/food/near-resort?country=Austria&resor…
                notice: Restaurant data © OpenStreetMap contributors, ODbL 1.0 (openstreetmap.org/cop…
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/food/venues:
    get:
      operationId: food_venues
      summary: Restaurants, cafes and bars in a ski area or mountain town of any country…
      description: 'Restaurants, cafes and bars in a ski area or mountain town of any country listed at /v1/food/coverage (e.g. Liptov/Jasna): every place to eat and drink with type, cuisine, address, coordinates, and where known opening hours, phone, website and whether a menu is available. Hours from OpenStreetMap, the restaurant''s website or Wolt. No Google data.'
      tags:
      - food
      parameters:
      - name: country
        in: query
        required: true
        schema:
          type: string
        example: Slovakia
      - name: area
        in: query
        required: true
        schema:
          type: string
        description: Area slug from /v1/food/coverage
        example: liptov-jasna
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/food/venues?country=Slovakia&area=liptov-jasna&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  area:
                    type: string
                  name:
                    type: string
                  country:
                    type: string
                  region:
                    type: string
                  bbox:
                    type: object
                    properties:
                      south:
                        type: number
                      west:
                        type: number
                      north:
                        type: number
                      east:
                        type: number
                  count:
                    type: integer
                  restaurants:
                    type: array
                    items:
                      type: object
                      properties:
                        restaurantId:
                          type: string
                        name:
                          type: string
                        type:
                          type: string
                        lat:
                          type: number
                        lon:
                          type: number
                        currency:
                          type: string
                        menuItemCount:
                          type: integer
                        osmUrl:
                          type: string
                        country:
                          type: string
                        area:
                          type: string
                  updatedAt:
                    type: string
                  notice:
                    type: string
              example:
                area: liptov-jasna
                name: Liptov / Jasná–Chopok + Liptovský Mikuláš gateway
                country: Slovakia
                region: Žilinský kraj
                bbox:
                  south: 48.92
                  west: 19.4323
                  north: 49.1458
                  east: 19.7808
                count: 196
                restaurants:
                - restaurantId: osm-node-6135561453
                  name: '24'
                  type: bar
                  lat: 49.036884
                  lon: 19.721031
                  currency: EUR
                  menuItemCount: 0
                  osmUrl: https://www.openstreetmap.org/node/6135561453
                  country: sk
                  area: liptov-jasna
                updatedAt: '2026-10-01T01:30:47Z'
                notice: Restaurant data © OpenStreetMap contributors, ODbL 1.0 (openstreetmap.org/cop…
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)