Búsqueda

Scrapea páginas de búsqueda de Kroger con filtros por rango de precio, marca y ubicación de tienda. Recupera resultados de búsqueda organizados vía API.

El kroger_search la fuente de datos está diseñada para recuperar páginas de búsqueda de Kroger.

Solicitar ejemplos

En los ejemplos de abajo, hacemos una solicitud para recuperar una página de resultados de búsqueda para la consulta running shoes, filtrar los resultados por la marca adidas y el rango de precios 100.00-200.00, y especificar el ID de la tienda como 1100002.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "kroger_search",
        "query": "running shoes",
        "price_range": "100.00-200.00",
        "brand": "adidas",
        "store_id": "01100002"
    }'

import requests
from pprint import pprint

# Estructurar la carga útil.
payload = {
    "source": "kroger_search",
    "query": "running shoes",
    "price_range": "100.00-200.00",
    "brand": "adidas",
    "store_id": "01100002",
}

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

# Imprimir la respuesta formateada en stdout.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "kroger_search",
    query: "running shoes",
    price_range: "100.00-200.00",
    brand: "adidas",
    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();

<?php

$params = array(
    "source" => "kroger_search",
    "query" => "running shoes",
    "price_range" => "100.00-200.00",
    "brand" => "adidas",
    "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);
?>

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_search",
		"query": "running shoes",
		"price_range": "100.00-200.00",
		"brand":      "adidas",
		"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)
	response, _ := client.Do(request)

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

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_search",
                query = "running shoes",
                price_range = "100.00-200.00",
                brand = "adidas",
                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.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

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

            Console.WriteLine(contents);
        }
    }
}

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_search");
        jsonObject.put("query", "running shoes");
        jsonObject.put("price_range", "100.00-200.00");
        jsonObject.put("brand", "adidas");
        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();
    }
}

Usamos el método de integración sincronizado Realtime en nuestros ejemplos. Si desea usar Proxy Endpoint o asincrónico Push-Pull de integración, consulte el métodos de integración sección.

Valores de los parámetros de la solicitud

Genérico

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

Parámetro

Descripción

Valor predeterminado

source

Configura el scraper.

kroger_search

query

La palabra clave o frase para buscar productos.

render

Activa el renderizado de JavaScript cuando se establece en html. Más información.

callback_url

URL de su endpoint de callback. Más información.

user_agent_type

Tipo de dispositivo y navegador. La lista completa se puede encontrar here.

desktop

- parámetro obligatorio

Localización

Personalice los resultados según las ubicaciones de las tiendas, áreas de entrega y métodos de cumplimiento preferidos.

Parámetro

Descripción

Valor predeterminado

Dependencias

store_id

Especifique una tienda. Vea los valores disponibles here. El ID debe comenzar con '0'.

Requerido cuando fulfillment_type está configurado en pickup o in_store.

delivery_zip

Especifique el código postal de entrega.

Requerido cuando fulfillment_type está configurado en delivery.

fulfillment_type

Especifique el método de cumplimiento del pedido. Valores disponibles: pickup, delivery, in_store.

pickup (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 pickup.

Si la fulfillment_type y store_id/delivery_zip combinación no es válida (no está soportada por Kroger), la página raspada devolverá un estado 404.

Filtrado

Opciones para filtrar y refinar los resultados de búsqueda según varios criterios.

Parámetro

Descripción

Valor predeterminado

price_range

Define el rango de precios deseado, formateado como min_price-max_price con dos decimales, separados por un guion (por ejemplo, 10.00-20.00).

brand

Filtra los resultados de búsqueda para incluir productos de una marca específica.

AnteriorProducto SiguienteURL

Última actualización hace 6 días

¿Te fue útil?

Buenas noches

hashtagSolicitar ejemplos

hashtagValores de los parámetros de la solicitud

hashtagGenérico

hashtagLocalización

hashtagFiltrado

Solicitar ejemplos

Valores de los parámetros de la solicitud

Genérico

Localización

Filtrado