Producto

Extrae datos de páginas de producto de Kroger, incluidos precios, disponibilidad y opciones de cumplimiento, usando ID de producto y especificaciones de tienda.

La kroger_product La fuente de datos está diseñada para recuperar páginas de productos de Kroger.

Ejemplos de solicitud

En el ejemplo siguiente, hacemos una solicitud para recuperar la página del producto para el ID de producto 0021006550000, especifique la ubicación de entrega usando el código ZIP 65401, establezca el tipo de fulfillment en delivery, y asigne el ID de la tienda a 1100002.

cURL

curl 'https://realtime.oxylabs.io/v1/queries' \\
--user 'USERNAME:PASSWORD' \\
-H 'Content-Type: application/json' \\
-d '{
        "source": "kroger_product",
        "product_id": "0021006550000",
        "delivery_zip": "65401",
        "fulfillment_type": "pickup",
        "store_id": "01100002"
    }'

Python

import requests
from pprint import pprint

# Estructura del payload.
payload = {
    "source": "kroger_product",
    "product_id": "0021006550000",
    "delivery_zip": "65401",
    "fulfillment_type": "pickup",
    "store_id": "01100002",
}

# Obtener respuesta.
response = requests.request(
    "POST",
    "https://realtime.oxylabs.io/v1/queries",
    auth=("USERNAME", "PASSWORD"),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

Node.js

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "kroger_product",
    product_id: "0021006550000",
    delivery_zip: "65401",
    fulfillment_type: "pickup",
    store_id: "01100002",
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

HTTP

https://realtime.oxylabs.io/v1/queries?source=kroger_product&product_id=0021006550000&delivery_zip=65401&fulfillment_type=pickup&store_id=01100002&access_token=12345abcde

PHP

<?php

$params = array(
    'source' => 'kroger_product',
    'product_id' => '0021006550000',
    'delivery_zip' => '65401',
    'fulfillment_type' => 'pickup',
    'store_id' => '01100002'
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

Golang

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source":          "kroger_product",
		"product_id":      "0021006550000",
		"delivery_zip":    "65401",
		"fulfillment_type": "pickup",
		"store_id":        "01100002",
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	request.Header.Set("Content-Type", "application/json")
	response, err := client.Do(request)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	defer response.Body.Close()

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

C#

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new
            {
                source = "kroger_product",
                product_id = "0021006550000",
                delivery_zip = "65401",
                fulfillment_type = "pickup",
                store_id = "01100002"
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.Encoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

Java

package org.example;

import okhttp3.*;
import org.json.JSONObject;

import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "kroger_product");
        jsonObject.put("product_id", "0021006550000");
        jsonObject.put("delivery_zip", "65401");
        jsonObject.put("fulfillment_type", "pickup");
        jsonObject.put("store_id", "01100002");

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);

            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

JSON

{
    "source": "kroger_product",
    "product_id": "0021006550000",
    "delivery_zip": "65401",
    "fulfillment_type": "pickup",
    "store_id": "01100002"
}

Usamos integración síncrona Realtime método de integración en nuestros ejemplos. Si deseas usar Proxy Endpoint o una integración asíncrona Push-Pull integración, consulta la métodos de integración sección.

Valores de los parámetros de solicitud

Genérico

Opciones básicas de configuración y personalización para extraer páginas de productos de Kroger.

Parámetro	Descripción	Valor predeterminado
source	Configura el scraper.	kroger_product
product_id	ID de producto de 13 caracteres.	-
render	Habilita el renderizado de JavaScript cuando se establece en html. Más información.	-
callback_url	URL para tu endpoint de callback. Más información	-
user_agent_type	Tipo de dispositivo y navegador. La lista completa se puede encontrar aquí.	desktop

- parámetro obligatorio

Localización

Personaliza los resultados según las ubicaciones de las tiendas, las áreas de entrega y los métodos de preparación preferidos.

Parámetro	Descripción	Valor predeterminado	Dependencias
store_id	Especifica una tienda. Consulta los valores disponibles aquí. El ID debe comenzar con '0'.	-	Requerido cuando fulfillment_type está establecido en pickup o in_store.
delivery_zip	Especifica el código postal de la ubicación de entrega.	-	Requerido cuando fulfillment_type está establecido en delivery.
fulfillment_type	Especifica el método de preparación del pedido. Valores disponibles: pickup, delivery, in_store.	in_store (si solo store_id se proporciona)	Requiere store_id para pickup y in_store, o delivery_zip para delivery.

Dependencias explicadas:

• pickup y in_store los valores usan el store_id parámetro para determinar la tienda correcta.
• delivery usa el delivery_zip parámetro para especificar la ubicación de entrega.
• Si solo store_id se proporciona, y fulfillment_type no se especifica, el tipo predeterminado es in_store.

Si la fulfillment_type y store_id/delivery_zip combinación no es válida (Kroger no la admite), la página extraída devolverá un estado 404.