Search For A Cart

get

https://api.mealme.ai/search/cart

Use this API to search for a set of products from over half a billion total products from grocery stores, electronic stores, etc. in the US and Canada.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

query

string

required

Defaults to {"Whole Milk": 1, "Eggs": 1}

A dictionary mapping each product query to the desired quantity

store_name

string

The store from which to search for carts within.

menu_id

string

The ID of the menu from which to search for carts within. The menu ID is provided by Get Inventory.

user_latitude

number

required

Defaults to 37.7786357

The latitude of the user.

user_longitude

number

required

Defaults to -122.3918135

The longitude of the user. In the US, this value is negative.

pickup

boolean

Defaults to false

If true, filter stores to only those that offer pickup. If false, filter to only stores with delivery.

budget

number

Defaults to 20

The maximum amount, in Dollars, that the user has specified they'd like to spend on an order. Required for applying a cheapest sort.

cuisine

string

The cuisine to filter products by.

user_street_num

string

Defaults to 188

Street number of the user. Required if fetch_quotes is true and pickup is false.

user_street_name

string

Defaults to King Street

Street name of the user. Required if fetch_quotes is true and pickup is false.

user_city

string

Defaults to San Francisco

City of the user. Required if fetch_quotes is true and pickup is false.

user_state

string

Defaults to CA

State abbreviation of the user. Required if fetch_quotes is true and pickup is false.

user_zipcode

string

Defaults to 94107

Zipcode of the user. Required if fetch_quotes is true and pickup is false.

user_country

string

Defaults to US

Country of the user. Can be US or CA. Required if fetch_quotes is true and pickup is false.

fetch_quotes

boolean

Defaults to false

Whether to fetch realtime delivery/pickup quotes. Note that this being true greatly increases response time. Note that if this is true and the query is also empty then store hours will not be in the response.

sort

string

Defaults to relevance

The sort type. Can be cheapest, fastest, rating, distance or the default relevance.

full_carts_only

boolean

Defaults to true

Whether to strictly return complete carts which contain product(s) for every product query in query.

split_cart

boolean

Defaults to false

Whether to return carts split across multiple stores.

fuzzy_search

boolean

Defaults to false

Whether to perform a lenient search that returns relevant products that may not exactly match the query.

open

boolean

Defaults to false

Whether or not to return only open restaurants.

maximum_miles

number

Defaults to 1.5

ex: 1.5. The maximum distance allowed, in miles.

dollar_signs

integer

ex: 2 (which would signal $$). Cost for the average meal. This can represent 1 ($) for the cheapest stores or 4 ($$$$) for the most expensive stores.

minimum_rating

number

ex: 4.6. The minimum rating allowed.

sale

boolean

Defaults to false

Whether to search for products that are currently on sale.

search_in_category

string

The category of the menu to search for carts within. The list of a menu's categories are provided by Get Inventory.

use_new_db

boolean

Defaults to true

Whether to perform the cart search among a new database. Note that if use_new_db is true, use_new_db must also be true when making a request to Get Inventory or Get MealMe Store with any store _id returned from this request.

Responses

200Success

400Input Validation Error

401Missing Authorization

429Too Many Requests