MealMe Search API

Store, product, and place search.

Operations 4

GET /search/store/v3 Search for a Store #
GET /search/product/v4 Search for a Product #
GET /search/cart Search for a Cart #
GET /places/search Search for a Place #

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/mealme-search-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

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

OpenAPI Specification

mealme-search-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: MealMe Food Ordering Search API
  version: 4.1.0
  description: 'MealMe provides a food and grocery ordering API for menus, inventory, and

    order placement at over one million restaurants and grocery stores in the

    United States and Canada.'
  contact:
    name: MealMe API Reference
    url: https://docs.mealme.ai/reference
servers:
- url: https://api.mealme.ai
  description: MealMe production API
security:
- apiKeyHeader: []
tags:
- name: Search
  description: Store, product, and place search.
paths:
  /search/store/v3:
    get:
      tags:
      - Search
      operationId: searchStores
      summary: Search for a Store
      description: Search restaurants and grocery stores near a location.
      parameters:
      - in: query
        name: query
        schema:
          type: string
        example: pizza
      - in: query
        name: latitude
        required: true
        schema:
          type: number
        example: 37.7786357
      - in: query
        name: longitude
        required: true
        schema:
          type: number
        example: -122.3918135
      - in: query
        name: store_type
        schema:
          type: string
          enum:
          - restaurant
          - grocery
        example: restaurant
      - in: query
        name: budget
        schema:
          type: number
          default: 20
        example: 20
      - in: query
        name: pickup
        schema:
          type: boolean
          default: false
        example: false
      - in: query
        name: fetch_quotes
        schema:
          type: boolean
          default: false
        example: false
      - in: query
        name: sort
        schema:
          type: string
          enum:
          - cheapest
          - fastest
          - rating
          - distance
          - relevance
        example: cheapest
      - in: query
        name: open
        schema:
          type: boolean
          default: false
        example: false
      - in: query
        name: maximum_miles
        schema:
          type: number
          default: 3
        example: 3
      - in: query
        name: page
        schema:
          type: integer
        example: 0
      responses:
        '200':
          description: Matching stores.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Store'
              examples:
                SearchStores200Example:
                  summary: Default searchStores 200 response
                  x-microcks-default: true
                  value:
                  - _id: 8c9f33d5-d138-4a49-9a4f-162f195c89b8
                    name: Tony's Pizza Napoletana
                    address: 188 King Street, San Francisco, CA 94107
                    type: restaurant
                    is_open: false
                    phone_number: '+14155550123'
                    cuisines:
                    - Pizza
                    - Italian
                    rating: 4.5
                    miles: 1.5
                    quotes: []
        '400':
          description: Input Validation Error
        '401':
          description: Missing Authorization
        '429':
          description: Too Many Requests
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /search/product/v4:
    get:
      tags:
      - Search
      operationId: searchProducts
      summary: Search for a Product
      description: Search products across restaurants, grocery, and retail stores.
      parameters:
      - in: query
        name: query
        schema:
          type: string
        example: pizza
      - in: query
        name: product_id
        schema:
          type: string
        example: prod_5a3e9d12
      - in: query
        name: store_name
        schema:
          type: string
        example: Tony's Pizza Napoletana
      - in: query
        name: menu_id
        schema:
          type: string
        example: id_7b2c4e
      - in: query
        name: user_latitude
        required: true
        schema:
          type: number
        example: 37.7786357
      - in: query
        name: user_longitude
        required: true
        schema:
          type: number
        example: -122.3918135
      - in: query
        name: pickup
        schema:
          type: boolean
          default: false
        example: false
      - in: query
        name: upc_codes
        schema:
          type: string
        example: example
      - in: query
        name: fetch_quotes
        schema:
          type: boolean
          default: false
        example: false
      - in: query
        name: sort
        schema:
          type: string
          enum:
          - relevance
          - cheapest
          - fastest
          - rating
          - distance
        example: relevance
      - in: query
        name: fuzzy_search
        schema:
          type: boolean
          default: false
        example: false
      - in: query
        name: maximum_miles
        schema:
          type: number
          default: 1.5
        example: 1.5
      - in: query
        name: sale
        schema:
          type: boolean
          default: false
        example: false
      - in: query
        name: page
        schema:
          type: integer
        example: 0
      responses:
        '200':
          description: Matching products.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Product'
              examples:
                SearchProducts200Example:
                  summary: Default searchProducts 200 response
                  x-microcks-default: true
                  value:
                  - product_id: prod_5a3e9d12
                    name: Tony's Pizza Napoletana
                    price: 1299
                    available: false
                    store_name: Tony's Pizza Napoletana
                    menu_id: id_7b2c4e
        '400':
          description: Input Validation Error
        '401':
          description: Missing Authorization
        '429':
          description: Too Many Requests
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /search/cart:
    get:
      tags:
      - Search
      operationId: searchCart
      summary: Search for a Cart
      description: Search for a set of products to build a cart in one call.
      responses:
        '200':
          description: Cart search results.
        '401':
          description: Missing Authorization
        '429':
          description: Too Many Requests
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /places/search:
    get:
      tags:
      - Search
      operationId: searchPlaces
      summary: Search for a Place
      description: Search for a place or address with optional location bias.
      parameters:
      - in: query
        name: search
        required: true
        schema:
          type: string
        example: pizza
      - in: query
        name: location_bias_latitude
        schema:
          type: number
        example: 37.7786357
      - in: query
        name: location_bias_longitude
        schema:
          type: number
        example: -122.3918135
      - in: query
        name: location_bias_radius
        schema:
          type: integer
          default: 10000
        example: 10000
      - in: query
        name: search_type
        schema:
          type: string
          enum:
          - place
          - address
          - addresses
          default: place
        example: place
      - in: query
        name: open_filter
        schema:
          type: boolean
          default: false
        example: false
      responses:
        '200':
          description: Matching places.
        '401':
          description: Missing Authorization
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    Product:
      type: object
      properties:
        product_id:
          type: string
          example: prod_5a3e9d12
        name:
          type: string
          example: Tony's Pizza Napoletana
        price:
          type: integer
          description: Price in cents.
          example: 1299
        available:
          type: boolean
          example: false
        store_name:
          type: string
          example: Tony's Pizza Napoletana
        menu_id:
          type: string
          example: id_7b2c4e
    Store:
      type: object
      properties:
        _id:
          type: string
          example: 8c9f33d5-d138-4a49-9a4f-162f195c89b8
        name:
          type: string
          example: Tony's Pizza Napoletana
        address:
          type: string
          example: 188 King Street, San Francisco, CA 94107
        type:
          type: string
          enum:
          - restaurant
          - grocery
          example: restaurant
        is_open:
          type: boolean
          example: false
        phone_number:
          type: string
          example: '+14155550123'
        cuisines:
          type: array
          items:
            type: string
          example:
          - Pizza
          - Italian
        rating:
          type: number
          example: 4.5
        miles:
          type: number
          example: 1.5
        quotes:
          type: array
          items:
            type: object
          example: []
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      in: header
      name: Authorization
      description: API key issued by MealMe, passed in the Authorization header.