# Rappi Product ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/rappi/product` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/rappi-product | ## Description Fetch one Rappi Mexico product, including the primary store price and the other store offers. The primary price can differ from a search card. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/rappi/product' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Santa Clara leche ```json { "url": "https://www.rappi.com.mx/p/santa-clara-leche-deslactosada-semi-14069", "city": "Ciudad de México", "name": "Santa Clara Leche Deslactosada Semidescremada 1 L", "image": "https://images.rappi.com.mx/products/40efda20-78c9-4351-b9e1-a860ab740866.png", "price": 33, "offers": [ { "price": 33, "currency": "MXN", "in_stock": true, "store_id": 1930460513, "store_url": "https://www.rappi.com.mx/tiendas/1930460513-city-market", "store_name": "City Market", "has_discount": false, "price_display": "$33.00", "original_price": null }, { "price": 33, "currency": "MXN", "in_stock": true, "store_id": 1930301321, "store_url": "https://www.rappi.com.mx/tiendas/1930301321-la-comer", "store_name": "La Comer", "has_discount": false, "price_display": "$33.00", "original_price": null }, { "price": 34, "currency": "MXN", "in_stock": true, "store_id": 1930455981, "store_url": "https://www.rappi.com.mx/tiendas/1930455981-chedraui-supercito", "store_name": "Chedraui Supercito", "has_discount": false, "price_display": "$34.00", "original_price": null }, { "price": 34, "currency": "MXN", "in_stock": true, "store_id": 1930103161, "store_url": "https://www.rappi.com.mx/tiendas/1930103161-mascotas-chedraui", "store_name": "Mascotas Chedraui", "has_discount": false, "price_display": "$34.00", "original_price": null }, { "price": 34, "currency": "MXN", "in_stock": true, "store_id": 1930195015, "store_url": "https://www.rappi.com.mx/tiendas/1930195015-super-che", "store_name": "Súper Che", "has_discount": false, "price_display": "$34.00", "original_price": null }, { "price": 35, "currency": "MXN", "in_stock": true, "store_id": 1930211752, "store_url": "https://www.rappi.com.mx/tiendas/1930211752-chedraui-selecto", "store_name": "Chedraui Selecto", "has_discount": false, "price_display": "$35.00", "original_price": null }, { "price": 35, "currency": "MXN", "in_stock": true, "store_id": 1930195033, "store_url": "https://www.rappi.com.mx/tiendas/1930195033-super-chedraui-selecto", "store_name": "Súper Chedraui Selecto", "has_discount": false, "price_display": "$35.00", "original_price": null }, { "price": 35.9, "currency": "MXN", "in_stock": true, "store_id": 1930392251, "store_url": "https://www.rappi.com.mx/tiendas/1930392251-turbo", "store_name": "Turbo", "has_discount": false, "price_display": "$35.90", "original_price": null }, { "price": 35.9, "currency": "MXN", "in_stock": true, "store_id": 1930024623, "store_url": "https://www.rappi.com.mx/tiendas/1930024623-turbo-farma", "store_name": "Turbo Farma", "has_discount": false, "price_display": "$35.90", "original_price": null }, { "price": 35.9, "currency": "MXN", "in_stock": true, "store_id": 1923301762, "store_url": "https://www.rappi.com.mx/tiendas/1923301762-turbo-fresh-angel-independencia", "store_name": "Turbo Fresh-Angel Independencia", "has_discount": false, "price_display": "$35.90", "original_price": null }, { "price": 37, "currency": "MXN", "in_stock": true, "store_id": 1930446726, "store_url": "https://www.rappi.com.mx/tiendas/1930446726-oxxo", "store_name": "OXXO", "has_discount": false, "price_display": "$37.00", "original_price": null }, { "price": 38.9, "currency": "MXN", "in_stock": true, "store_id": 942001337, "store_url": "https://www.rappi.com.mx/tiendas/942001337-soriana-hiper", "store_name": "Soriana Híper", "has_discount": false, "price_display": "$38.90", "original_price": null }, { "price": 40.5, "currency": "MXN", "in_stock": true, "store_id": 1930171590, "store_url": "https://www.rappi.com.mx/tiendas/1930171590-soriana-mercado", "store_name": "Soriana Mercado", "has_discount": false, "price_display": "$40.50", "original_price": null }, { "price": 42.03, "currency": "MXN", "in_stock": true, "store_id": 1930230975, "store_url": "https://www.rappi.com.mx/tiendas/1930230975-justo", "store_name": "Jüsto", "has_discount": false, "price_display": "$42.03", "original_price": null }, { "price": 43.13, "currency": "MXN", "in_stock": true, "store_id": 1930095502, "store_url": "https://www.rappi.com.mx/tiendas/1930095502-7-eleven", "store_name": "7 Eleven", "has_discount": false, "price_display": "$43.13", "original_price": null }, { "price": 44.4, "currency": "MXN", "in_stock": true, "store_id": 160195150, "store_url": "https://www.rappi.com.mx/tiendas/160195150-farmacias-guadalajara", "store_name": "Farmacias Guadalajara", "has_discount": false, "price_display": "$44.40", "original_price": null } ], "category": "Leche natural", "currency": "MXN", "in_stock": true, "store_id": 1930460513, "store_url": "https://www.rappi.com.mx/tiendas/1930460513-city-market", "unit_type": "l", "product_id": "975243808", "store_name": "City Market", "unit_price": "$0.0330/ml", "description": "Esta leche te aporta la misma cantidad de calcio, vitaminas y proteínas que la leche normal, pero sin lactosa. Tiene menor porcentaje de grasa, sabe perfecta sola, con cereal, café, fría o caliente.", "has_discount": false, "max_quantity": 21, "min_quantity": 1, "presentation": "1 X 1 L", "price_display": "$33.00", "original_price": null, "master_product_id": 14069, "alcoholic_beverage": false, "has_age_restriction": false, "requires_prescription": false } ``` ## Documentation ## Overview Fetch one Rappi Mexico product. The city on the page is Ciudad de México and the host is rappi.com.mx. ``` GET https://api.piloterr.com/v2/rappi/product?query=https://www.rappi.com.mx/p/santa-clara-leche-deslactosada-semidescremada-1-l-14069 ``` Header: `x-api-key`. `query` is required. Pass `url` from search, or the numeric master id, for example `14069`. The price on this page is the primary store. It can differ from a search card because that card is another store. For master id `14069`, search showed Turbo Fresh-Angel Independencia at `$35.90`, and this page showed City Market at `$33.00`. `name` and `master_product_id` still match. `offers` lists the stores, including the search store at `$35.90`. `price` and `price_display` on this object agree with each other. The same is true inside each offer. ## Parameters `query` is required. Example: `https://www.rappi.com.mx/p/santa-clara-leche-deslactosada-semidescremada-1-l-14069`, or `14069`. ## Response fields `product_id` is the primary store's listing id. It can differ from `product_id` on a search row for another store. `master_product_id` is the catalog id and matches search. `name`, `url`, `image`, `description`, `category`, and `presentation` describe the product. This milk is category `Leche natural` and presentation `1 X 1 L`. `price`, `price_display`, `currency` (`MXN`), `original_price`, `has_discount`, and `in_stock` describe the primary offer. `unit_type` and `unit_price` are the unit fields. The unit string on this page can differ in format from the search card, for example `$0.0330/ml` here and `0.0359/ml` on the search row. `requires_prescription`, `has_age_restriction`, and `alcoholic_beverage` are booleans. `min_quantity` and `max_quantity` are integers. `store_id`, `store_name`, and `store_url` are the primary store. `city` is `Ciudad de México`. `offers` is a list. Each item has `store_id`, `store_name`, `store_url`, `price`, `price_display`, `currency`, `in_stock`, `has_discount`, and `original_price`. The first offer is the primary store. ## Use cases - A shopping app shows the primary store price and the `offers` list for the same 1 L carton. - A catalog check reads `requires_prescription` and `has_age_restriction` before it lists a SKU. - A marketplace compares the search-card price at Turbo with the product-page price at City Market for master id `14069`. ## Error codes - 400: `query` is not a rappi.com.mx product URL or a numeric master id. - 404: the product page has no primary store. - 401: missing API key.