Alimentation et livraison
Kroger Scraper
kroger.com
Kroger fait tourner toutes ses enseignes de supermarchés sur une même plateforme en ligne, et les deux mêmes endpoints de plugin couvrent chacune d'elles : Kroger, Ralphs, Fred Meyer, King Soopers, Fry's, Smith's, QFC, Dillons, Baker's, City Market, Gerbes, Food 4 Less, Harris Teeter, Mariano's, Metro Market, Pick 'n Save, Jay C, Pay Less et FoodsCo, choisies avec le paramètre banner. Les prix, les promotions, le stock et les rayons appartiennent à un magasin donné, chaque appel est donc calculé pour un seul : un store_id, le magasin de l'enseigne le plus proche d'un zip (avec les autres magasins proches dans la liste, si vous en voulez un autre) ou le magasin par défaut de l'enseigne si vous n'indiquez rien, et la réponse nomme toujours le magasin. L'endpoint de recherche renvoie la première page de résultats, jusqu'à 24 produits dans l'ordre du site, chacun avec son identifiant produit Kroger, son UPC, son nom, sa marque, sa taille, son lien et son image, le prix actuel, le prix habituel et un éventuel prix promotionnel avec l'économie, la promotion (promo, baisse de prix, offre par lot, achat obligatoire de plusieurs unités ou un acheté un offert), le prix unitaire, s'il est vendu au poids, le niveau de stock et la quantité maximale commandable, s'il peut être retiré, livré, acheté en magasin ou expédié, le rayon, la travée et l'étagère, la note et le nombre d'avis, ses catégories, l'éligibilité SNAP, les offres supplémentaires et l'indicateur sponsorisé ; brand limite la recherche à une ou plusieurs marques. L'endpoint produit accepte un identifiant produit Kroger, un code-barres UPC ou GTIN, ou un lien produit de n'importe quelle enseigne, et ajoute la description et les points forts, toutes les images du produit, les ingrédients, les allergènes, les valeurs nutritionnelles par portion avec le % de l'apport journalier, les mentions diététiques et nutritionnelles, le chemin de catégories, le pays d'origine, la conservation, les dimensions et le poids. Aucun compte Kroger, connexion ni clé d'API n'est nécessaire.
Ce que vous pouvez extraire
- Identifiant produit Kroger, UPC et GTIN-14, nom, marque, taille, lien produit et image
- Prix, prix habituel et prix promotionnel avec l'économie, et le prix unitaire (par exemple 0,02 $ par fl oz)
- Promotion : promo, baisse de prix, offre par lot avec sa quantité et son prix, achat obligatoire de plusieurs unités ou un acheté un offert, avec sa date de fin ; offres supplémentaires
- Niveau de stock, disponibilité et quantité maximale commandable ; disponibilité en retrait, en livraison, en magasin et en expédition
- Rayon, travée et étagère dans le magasin choisi, note et nombre d'avis, catégories, éligibilité SNAP et indicateur sponsorisé
- Le magasin auquel correspondent les prix (identifiant, nom, adresse, coordonnées, horaires, retrait ou magasin) et, avec un ZIP, les magasins proches
- Recherche sur n'importe laquelle des 19 enseignes, aux prix d'un identifiant de magasin, d'un ZIP ou du magasin par défaut, filtrée par marque ; jusqu'à 24 produits par appel
- Détail produit : description et points forts, toutes les images, ingrédients, allergènes, valeurs nutritionnelles avec % de l'apport journalier, mentions diététiques et nutritionnelles, chemin de catégories, pays d'origine, conservation, dimensions et poids
Endpoints dédiés
/groceries/kroger-search Recherche sur Kroger et ses enseignes
Les produits correspondant à query sur une enseigne (kroger, ralphs, fredmeyer, kingsoopers, frysfood, smithsfoodanddrug, qfc, dillons, bakersplus, citymarket, gerbes, foodfourless, harristeeter, marianos, metromarket, picknsave, jaycfoods, payless ou foodsco ; kroger par défaut), aux prix d'un magasin : store_id, le magasin le plus proche de zip ou le magasin par défaut de l'enseigne. Renvoie store (storeId, name, banner, address, latitude, longitude, fulfillmentMethods, hours, pricesFor, selectedBy), totalResults et jusqu'à 24 products avec productId, upc, gtin14, name, brand, size, url, image, price, regularPrice, salePrice, onSale, savings, promotion (type, text, quantity, quantityPrice, expiresAt), unitPrice (price, unit, text), soldBy, priceIsEstimate, currency (USD), available, stockLevel, maxOrderQuantity, fulfillment (pickup, delivery, inStore, ship), aisle (number, description, side, bay, shelf), rating, reviewCount, categories, snapEligible, offers, position et sponsored. brand accepte une ou plusieurs marques séparées par | et max_results va de 1 à 24 ; avec zip, nearbyStores liste les magasins de l'enseigne à proximité.
/groceries/kroger-product Produit Kroger et de ses enseignes
Un produit par product (un identifiant produit Kroger à 13 chiffres, un code-barres UPC ou GTIN, ou un lien produit de n'importe quelle enseigne, qui choisit son enseigne lui-même), aux prix de store_id, du magasin le plus proche de zip ou du magasin par défaut de l'enseigne. Renvoie store et product avec tous les champs de la recherche plus description, highlights, images, ingredients, allergens, nutrition (servingSize, servingsPerContainer, nutrients avec amount, unit et dailyValuePercent), dietary, claims, organic, glutenFree, kosher, nonGmo, taxonomy, countryOfOrigin, storage, dimensions, weight, ratingBreakdown, alcohol et ageRestricted.
Comment le scraper
curl -X POST \
-H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
"https://api.scrapeunblocker.com/groceries/kroger-search?query=milk&banner=kroger&zip=45202"import requests
resp = requests.post(
"https://api.scrapeunblocker.com/groceries/kroger-search",
headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
params={"query": "milk", "banner": "kroger", "zip": "45202"},
)
print(resp.text)import { ScrapeUnblockerClient } from 'scrapeunblocker';
const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });
const results = await su.krogerSearch('milk', {
banner: 'ralphs',
zip: '90012',
});
const product = await su.krogerProduct('0001111041700', {
storeId: '01400929',
});
console.log(results);
console.log(product); Les requêtes sont en POST et passent leurs paramètres dans la query string. Le rendu navigateur a toujours lieu : aucun flag à activer.
Exemple de réponse
{
"banner": "kroger",
"bannerName": "Kroger",
"query": "milk",
"brands": [],
"store": {
"storeId": "01400473",
"name": "Newport",
"banner": "kroger",
"address": {
"line1": "20 W 6th St",
"line2": null,
"city": "Newport",
"state": "KY",
"zip": "41071",
"country": "US"
},
"latitude": 39.0894902,
"longitude": -84.494807,
"fulfillmentMethods": ["pickup", "inStore"],
"hours": [ { "days": "Sun - Sat", "hours": "6:00 AM - 10:00 PM" } ],
"pricesFor": "pickup",
"selectedBy": "zip"
},
"totalResults": 832,
"resultsCollected": 1,
"products": [
{
"productId": "0001111041700",
"upc": "011110417008",
"gtin14": "00011110417008",
"name": "Kroger® 2% Reduced Fat Milk Gallon",
"brand": "Kroger",
"size": "1 gal",
"url": "https://www.kroger.com/p/kroger-2-reduced-fat-milk-gallon/0001111041700",
"image": "https://www.kroger.com/product/images/large/front/0001111041700",
"price": 2.89,
"regularPrice": 2.89,
"salePrice": null,
"onSale": false,
"savings": null,
"promotion": null,
"unitPrice": { "price": 0.0226, "unit": "fl oz", "text": "$0.02/fl oz" },
"soldBy": "unit",
"priceIsEstimate": false,
"currency": "USD",
"priceText": "$2.89",
"available": true,
"stockLevel": "HIGH",
"unavailableReason": null,
"maxOrderQuantity": 140,
"fulfillment": { "pickup": true, "delivery": true, "inStore": true, "ship": false },
"aisle": { "number": "100", "description": "DAIRY", "side": "L", "bay": "18", "shelf": "2" },
"rating": 3.09,
"reviewCount": 88,
"categories": ["Dairy"],
"snapEligible": true,
"offers": [],
"position": 1,
"sponsored": false
}
],
"url": "https://www.kroger.com/search?query=milk",
"nearbyStores": [
{
"storeId": "01400513",
"name": "Kroger On the Rhine",
"banner": "kroger",
"address": {
"line1": "100 E Court St",
"line2": null,
"city": "Cincinnati",
"state": "OH",
"zip": "45202",
"country": "US"
},
"latitude": 39.10682,
"longitude": -84.51253,
"phone": "(513) 263-5900",
"distanceMiles": 0.08,
"fulfillmentMethods": ["inStore"],
"hours": [ { "days": "Sun - Sat", "hours": "6:00 AM - 10:00 PM" } ]
}
]
} Lire la documentation de l'API
Questions fréquentes
Le scraping de Kroger est-il légal ?
Collecter des données Kroger publiques comme les noms des produits, les prix en rayon, les prix unitaires et les promotions est licite dans de nombreuses juridictions, mais les règles dépendent de votre pays, des données collectées et de leur usage. ScrapeUnblocker renvoie les données produit publiques ; ce que vous collectez et comment vous l'utilisez relève de votre responsabilité.
Comment scraper Kroger sans se faire bloquer ?
Kroger et ses enseignes sont protégés par Akamai Bot Manager, qui refuse les clients HTTP simples sur les pages produit et catégorie et sur la propre API de recherche du site, et coupe la connexion des adresses IP dont il se méfie. Les plugins /groceries/kroger-search et /groceries/kroger-product lisent la page de recherche rendue côté serveur, qui contient les fiches produit complètes pour le magasin choisi, si bien qu'un produit est lu comme une recherche de son identifiant, sans aucun navigateur ; un appel dont la connexion est refusée passe à une session neuve sur une autre sortie ISP. Dans le benchmark de ScrapeUnblocker, 100 % des 1 072 appels sur les 19 enseignes (672 recherches avec à chaque fois un terme, un magasin ou un ZIP différent, et 400 pages produit) ont renvoyé des données, en environ 2,5 s par appel.
Quelles données Kroger puis-je obtenir ?
Pour chaque produit d'une recherche : l'identifiant produit Kroger, l'UPC, le nom, la marque, la taille, le lien et l'image, le prix actuel, habituel et promotionnel avec l'économie, le type, le texte, la quantité de l'offre par lot et la date de fin de la promotion, le prix unitaire, la vente au poids, le niveau de stock et la quantité maximale commandable, la disponibilité en retrait, livraison, magasin et expédition, le rayon, la travée et l'étagère, la note et le nombre d'avis, les catégories, l'éligibilité SNAP, les offres supplémentaires et l'indicateur sponsorisé. L'endpoint produit ajoute la description, les points forts, toutes les images, les ingrédients, les allergènes, les valeurs nutritionnelles par portion avec le % de l'apport journalier, les mentions diététiques et nutritionnelles, le chemin de catégories, le pays d'origine, la conservation, les dimensions, le poids et la répartition des notes.
Quelles enseignes et quels magasins sont couverts, et comment choisir un magasin ?
Les 19 sites de la plateforme Kroger : Kroger, Ralphs, Fred Meyer, King Soopers, Fry's, Smith's, QFC, Dillons, Baker's, City Market, Gerbes, Food 4 Less, Harris Teeter, Mariano's, Metro Market, Pick 'n Save, Jay C, Pay Less et FoodsCo, choisis avec banner. Les prix et le stock varient d'un magasin à l'autre : passez store_id (l'identifiant à 8 chiffres affiché dans chaque réponse) ou zip, qui prend les prix du magasin de l'enseigne le plus proche acceptant les commandes en ligne et liste les autres magasins proches dans nearbyStores. Sans l'un ni l'autre, chaque enseigne utilise un magasin par défaut fixe, et store dans la réponse indique toujours le magasin utilisé.
Faut-il un compte Kroger ou une IP américaine ?
Non. Aucun compte Kroger, carte de fidélité ou connexion n'est nécessaire, ni adresse américaine à vous : le magasin vient de store_id ou de zip, pas de l'endroit d'où la requête est envoyée. Les prix sont ceux du magasin pour le retrait (les prix en magasin pour les magasins sans retrait), en USD.
Combien coûte le scraping de Kroger ?
Chaque appel est une requête : une recherche renvoie jusqu'à 24 produits et un appel produit renvoie un produit avec tous ses détails. 1 requête = 1 crédit, 1,00 EUR pour 1 000 en paiement à l'usage, en descendant jusqu'à environ 0,55 EUR pour 1 000 sur l'offre Ultimate. Les blocages et les timeouts ne sont pas facturés, et l'essai gratuit inclut 500 requêtes sans carte bancaire.
Scrapers similaires
Kroger et les autres noms et marques de kroger.com appartiennent à leur titulaire et ne servent ici qu'à désigner le site avec lequel cette API fonctionne. ScrapeUnblocker est un service indépendant, sans lien avec le titulaire de kroger.com, et n'est ni approuvé ni parrainé par lui.
Commencez à scraper ce site dès aujourd'hui
Palier gratuit inclus. Aucune carte bancaire requise pour tester.