Uber Eats API: Search restaurants
Find restaurants delivering to an address in Uber Eats guest browsing order. Fees can be conditional for new users; displayed rating counts may be rounded.
Unofficial. Not affiliated with or endorsed by Uber Eats.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Query optional
query Cuisine or dish to search for, for example ramen. Leave blank for all restaurants.
(default)
- Address, required
address Delivery street address or postcode, for example 1 Market St, San Francisco.
10001
- Max Results optional
max_results Maximum restaurants to return, for example 20.
3
Whole number from 1 to 50. Default
20.
Input as JSON
{ "address": "10001", "max_results": 3}Output
{ "restaurants": [ { "name": "Shake Shack", "cuisine": "Burgers, Chicken, American, Desserts", "store_id": "4e2074d5-c8f6-49c3-a0a6-7fca8aab31b9", "photo_link": "https://tb-static.uber.com/prod/image-proc/processed_images/5df405fe65800c763f335a5200a406ef/811141f8f192e16f7ae3ad5ab7d1de57.jpeg" , "store_link": "https://www.ubereats.com/store/shake-shack-herald-square/TiB01cj2ScOgpn_KiqsxuQ" , "price_range": "$", "star_rating": 4.5, "delivery_fee": 0, "currency_code": "USD", "number_of_ratings": 10000, "delivery_fee_as_shown": "$0 delivery fee (new users)", "estimated_delivery_time": "17 min" }, { "name": "Five Guys", "cuisine": "American, Burgers, Hot Dog, Family Meals, Sandwich, Fast Food, Snacks", "store_id": "141fe48f-cc13-47d3-9bdc-7c9fd1891e8b", "photo_link": "https://tb-static.uber.com/prod/image-proc/processed_images/ef1af9b2b23998286392989a5704fa69/7d9011fd8e36c5a7ce512c5a2f2d7fe5.jpeg" , "store_link": "https://www.ubereats.com/store/five-guys-343-7th-ave-ny-1361/FB_kj8wTR9Ob3Hyf0Ykeiw" , "price_range": "$", "star_rating": 4.7, "delivery_fee": 0, "currency_code": "USD", "number_of_ratings": 2000, "delivery_fee_as_shown": "$0 delivery fee (new users)", "estimated_delivery_time": "12 min" }, { "name": "Applebee's", "cuisine": "American, Burgers, Salads, Comfort Food, Pasta, Sandwiches, Steak, Wings", "store_id": "76bb8ced-532a-442e-9584-18cd05e3c9a3", "photo_link": "https://tb-static.uber.com/prod/image-proc/processed_images/1e74b1d3a482dcd5c3c0811289c71f3b/19ec62ba51fde35ba0aff5b84321c5af.jpeg" , "store_link": "https://www.ubereats.com/store/applebees-midtown-west-42nd-%26-8th/druM7VMqRC6VhBjNBePJow" , "price_range": "$$$", "star_rating": 4.5, "delivery_fee": 0, "currency_code": "USD", "number_of_ratings": 1000, "delivery_fee_as_shown": "$0 delivery fee (new users)", "estimated_delivery_time": "22 min" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ubereats.com/search_restaurants","input":{"address":"10001","max_results":3}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "ubereats.com/search_restaurants" , "input": { "address": "10001", "max_results": 3 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "ubereats.com/search_restaurants" , "input": { "address": "10001", "max_results": 3 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run ubereats.com/search_restaurants# with {"address":"10001","max_results":3}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "address" ], "properties": { "query": { "type": "string", "default": "", "description": "Cuisine or dish to search for, for example ramen. Leave blank for all restaurants." }, "address": { "type": "string", "minLength": 1, "description": "Delivery street address or postcode, for example 1 Market St, San Francisco." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum restaurants to return, for example 20." } }}Output schema
{ "type": "object", "required": [ "restaurants" ], "properties": { "restaurants": { "type": "array", "items": { "type": "object", "required": [ "name", "cuisine", "star_rating", "number_of_ratings", "delivery_fee", "currency_code", "delivery_fee_as_shown", "estimated_delivery_time", "price_range", "photo_link", "store_link", "store_id" ], "properties": { "name": { "type": "string" }, "cuisine": { "type": [ "string", "null" ] }, "store_id": { "type": "string" }, "photo_link": { "type": [ "string", "null" ] }, "store_link": { "type": "string" }, "price_range": { "type": [ "string", "null" ] }, "star_rating": { "type": [ "number", "null" ] }, "delivery_fee": { "type": [ "number", "null" ] }, "currency_code": { "type": [ "string", "null" ] }, "number_of_ratings": { "type": [ "integer", "null" ] }, "delivery_fee_as_shown": { "type": [ "string", "null" ] }, "estimated_delivery_time": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
ubereats.com/search_restaurants- Returns
- name, cuisine, star rating, rating count, delivery fee, ETA, price range, photo, store link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method ubereats.com/search_restaurants with the inputs above.
Ask your agent
- Find ramen places that deliver to 1 Market St, San Francisco and show their ratings, delivery fees, and ETAs
- What restaurants on Uber Eats deliver to 10001? Give me the top 30 with cuisine and price range
- I'm at 742 Evergreen Terrace, Springfield — which Thai spots can deliver here and how long would it take?
- List up to 10 pizza restaurants delivering to 350 5th Ave, New York, including star ratings and links to each store
- Check Uber Eats for sushi delivery to SW1A 1AA and compare delivery fees and estimated arrival times
See more
All Uber Eats methodsGets the delivery menu, prices, rating and delivery details of the nearest matching Uber Eats restaurant at a city or address. For a city, a central listed address is used; delivery fees may reflect guest promotions, and rating counts may be rounded.
ubereats.com/get_restaurant_menuFinds DoorDash restaurants delivering to a street address or ZIP code, optionally for a cuisine or dish, in DoorDash's search order. Fees and times reflect guest offers; the numeric fee is null when DoorDash shows no amount.
doordash.com/search_restaurantsLists Tripadvisor's ranked restaurants in a city from the first results page, optionally filtered by cuisine and price category. Sponsored listings are left out; up to 30 restaurants with rating, review count, cuisines, price range and address.
tripadvisor.com/list_top_restaurantsLists Michelin Guide restaurants in a city or region, in Guide order, optionally filtered by distinction and cuisine, with each restaurant's address, description and photo. Results may include the surrounding area as labeled by the Guide.
guide.michelin.com/search_restaurantsFinds OpenTable restaurants with bookable slots within two hours of the selected time in a city or neighborhood, in OpenTable search order, optionally for one cuisine. Examines up to 300 listings; availability may change.
opentable.com/search_available_tablesGets a restaurant's public OpenTable profile by name or OpenTable link and city, including ratings, details, menu and photo links. Ratings and other fields can be missing when the restaurant does not publish them.
opentable.com/get_restaurantSearches a named Instacart store's guest-visible grocery products for a US ZIP code. Prices are in USD and can differ from in-store prices; stock estimates can change.
instacart.com/search_productsFinds McDonald's restaurants within 50 miles of a US city, address or ZIP code, nearest first. Each result includes today's hours, services and directions. Open-now status follows the listed hours.
mcdonalds.com/search_restaurants