rappi.com.mx APIwww.rappi.com.mx ↗
Access Rappi Mexico restaurant listings, menus, prices, ratings, and delivery info by location or keyword. 3 endpoints covering search, browse, and menu detail.
curl -X GET 'https://api.parse.bot/scraper/b9f65531-2721-425e-b2d7-72292886c34d/search_restaurants?limit=2&query=sushi' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for restaurants and their products by keyword query. Returns matching restaurants with their product listings including prices, ratings, and delivery information.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of restaurants to return |
| query | string | Search keyword (e.g., 'pizza', 'sushi', 'tacos') |
{
"type": "object",
"fields": {
"query": "search keyword used",
"stores": "array of restaurant objects, each containing store_id, name, brand_name, rating, delivery_time, status, and products array",
"total_stores": "total number of matching stores"
},
"sample": {
"data": {
"query": "tacos",
"stores": [
{
"url": "https://www.rappi.com.mx/restaurantes/990003467",
"logo": "https://images.rappi.com.mx/restaurants_logo/taco-naco-sr-logo1-1569353316352.png?e=webp&q=80&d=200x200",
"name": "Taco Naco - San Rafael",
"rating": 4.3,
"status": "OPEN",
"brand_id": 1870,
"category": "restaurants",
"products": [
{
"name": "Taco de pastor",
"image": "https://images.rappi.com.mx/products/d68d63f4-2748-4941-a7a0-64ee6f6803b1.jpeg?e=webp&q=80&d=130x130",
"price": 39,
"in_stock": true,
"product_id": 1665307,
"has_discount": false,
"original_price": 39
}
],
"store_id": 990003467,
"promotion": "Agrega 3, paga 2",
"brand_name": "Taco Naco",
"delivery_cost": 0,
"delivery_time": "14 min",
"has_free_shipping": false,
"delivery_time_minutes": 14
}
],
"total_stores": 5
},
"status": "success"
}
}About the rappi.com.mx API
The Rappi Mexico API exposes 3 endpoints for searching and browsing restaurants on rappi.com.mx, retrieving location-based listings, and pulling full menu data. The get_restaurant_details endpoint returns a complete menu broken into categories, with per-product prices, descriptions, and availability, alongside schedule, ratings, and current open/closed status.
Endpoints and Data Covered
The API has three endpoints. list_restaurants accepts lat and lng coordinates and returns a ranked array of nearby restaurants, each with store_id, name, brand_name, rating, total_reviews, delivery_time, delivery_price, status, and address. The limit parameter controls how many results come back. search_restaurants takes a query string (e.g. "pizza", "sushi") and returns matching stores with their associated product listings, including prices and ratings, as well as a total_stores count for the query.
Menu and Restaurant Detail
get_restaurant_details takes a store_id — obtainable from either of the listing endpoints — and returns the most detailed response. The menu field is an array of category objects, each containing a products array with product_id, name, description, price, and availability. The top-level response also includes tags (cuisine strings), schedule (day/time objects for opening hours), category, brand_name, address, rating, and status.
Coverage and Scope
All three endpoints target rappi.com.mx, so restaurant coverage reflects what Rappi Mexico surfaces for a given coordinate or search term. Geographic queries depend on providing valid Mexican coordinates via lat and lng. Store IDs are integers and are consistent across endpoints, so a store_id from list_restaurants can be passed directly to get_restaurant_details.
- Map nearby Rappi Mexico restaurants by GPS coordinates and display delivery time and price estimates.
- Build a food search tool that queries restaurants and products by keyword and surfaces prices.
- Aggregate menu data across multiple restaurants to compare pricing for a specific dish category.
- Monitor a restaurant's open/closed status and schedule across the week using the
schedulefield. - Collect cuisine tags and categories from
get_restaurant_detailsto classify restaurants by type. - Track
ratingandtotal_reviewsacross restaurants for competitive analysis in a specific area.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Rappi have an official public developer API?+
What does `search_restaurants` return beyond restaurant names?+
stores array includes store_id, name, brand_name, rating, delivery_time, status, and a products array with item-level data. The total_stores field tells you how many matches the query found in total, regardless of the limit applied.Does the API return user reviews or individual review text?+
rating and total_reviews counts from list_restaurants, and a numeric rating from get_restaurant_details, but individual review text and reviewer details are not included. You can fork this API on Parse and revise it to add an endpoint covering review content.Is the restaurant data limited to a specific region of Mexico?+
list_restaurants uses the lat and lng you provide, so results reflect whatever Rappi Mexico serves at that location. Only Mexican Rappi coordinates are in scope — rappi.com.mx does not cover other country domains. You can fork this API on Parse and revise it to target a different Rappi country domain if needed.Can I retrieve product images or promotional banner images from menus?+
menu products array returns product_id, name, description, price, and availability, but image URLs are not included in the current response shape. You can fork this API on Parse and revise it to add image fields to the product response.