Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Rappi Search

Recherche Rappi Mexique sur rappi.com.mx. La ville est Mexico. Chaque ligne est une offre de magasin, et next est null.

Actif1 crédit = 1 requêteGET/v2/rappi/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

Recherche Rappi Mexique. La vitrine est rappi.com.mx et le site fixe la ville sur Ciudad de México. Les autres domaines pays renvoient 400.

GET https://api.piloterr.com/v2/rappi/search?query=leche

En-tête : x-api-key.

Chaque ligne est l'offre d'un magasin pour un produit. Le même produit peut apparaître plusieurs fois, une fois par magasin. product_id peut se répéter. La paire product_id plus store_id ne se répète pas.

La charge utile n'a pas de page suivante, donc pagination.next est null. Un page supérieur à 1 renvoie 404.

price est un nombre en MXN et price_display est le même montant avec un signe dollar et deux décimales, par exemple 35.9 et $35.90. La page produit peut afficher un autre prix parce que son magasin principal n'est pas le magasin de cette carte.

ParamètresLink to Paramètres

query est obligatoire. Exemple : leche. Une URL de recherche mexicaine fonctionne : https://www.rappi.com.mx/search?query=leche. Une URL produit est refusée ici.

page est facultatif. Seule la page 1 renvoie des lignes. Exemple : 1.

Champs de réponseLink to Champs de réponse

product_id est l'id de l'offre en magasin. master_product_id est l'id catalogue, par exemple 14069 pour ce lait Santa Clara. name est le nom. url est la page produit sur rappi.com.mx. Ouvrez cette URL sur /v2/rappi/product.

price est un nombre. price_display lui correspond, par exemple $35.90. currency vaut MXN. original_price est le montant avant remise quand has_discount est vrai, sinon null. has_discount et in_stock sont des booléens.

unit_type est une unité courte, par exemple l. unit_price est la chaîne d'unité du site, par exemple 0.0359/ml. image est une image produit.

store_id, store_name et store_url identifient le magasin. eta est une fenêtre de livraison, par exemple 9 - 12 min. shipping_cost est un nombre. has_free_shipping est un booléen. store_promotion est le texte de bannière du magasin, ou null.

PaginationLink to Pagination

pagination.page vaut 1. pagination.per_page est le nombre de lignes de cette réponse. Pour leche c'était 208. pagination.total_results et pagination.total_pages sont null. pagination.next est null parce que la charge utile n'a pas de page suivante.

Il n'y a pas de page 2 à demander.

Cas d'usageLink to Cas d'usage

  • Une marque compare les prix du lait Santa Clara entre les magasins de Mexico dans une seule réponse, avec master_product_id 14069.
  • Un opérateur de dark store garde les lignes in_stock vraies et lit eta et shipping_cost.
  • Un suivi de prix stocke product_id avec store_id, parce que la même brique est listée par beaucoup de magasins.

Codes d'erreurLink to Codes d'erreur

  • 400 : query vide, URL produit, ou hôte Rappi autre que rappi.com.mx.
  • 404 : aucun produit, ou page supérieur à 1.
  • 401 : clé API absente.

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus