# Búsqueda El `kroger_search` la fuente de datos está diseñada para recuperar páginas de búsqueda de Kroger. ## Ejemplos de solicitud En los ejemplos siguientes, 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`. {% tabs %} {% tab title="cURL" %} ```bash 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" }' ``` {% endtab %} {% tab title="Python" %} ```python import requests from pprint import pprint # Estructura la carga útil. payload = { "source": "kroger_search", "query": "running shoes", "price_range": "100.00-200.00", "brand": "adidas", "store_id": "01100002", } # Obtén la respuesta. response = requests.request( "POST", "https://realtime.oxylabs.io/v1/queries", auth=("USERNAME", "PASSWORD"), json=payload, ) # Imprime la respuesta con formato en stdout. pprint(response.json()) ``` {% endtab %} {% tab title="Node.js" %} ```javascript 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(); ``` {% endtab %} {% tab title="HTTP" %} ```http https://realtime.oxylabs.io/v1/queries?source=kroger_search&query=running+shoes&price_range=100.00-200.00&brand=adidas&store_id=01100002&access_token=12345abcde ``` {% endtab %} {% tab title="PHP" %} ```php "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); ?> ``` {% endtab %} {% tab title="Golang" %} ```go 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)) } ``` {% endtab %} {% tab title="C#" %} ```csharp 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); } } } ``` {% endtab %} {% tab title="Java" %} ```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_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(); } } ``` {% endtab %} {% tab title="JSON" %} ```json { "source": "kroger_search", "query": "running shoes", "price_range": "100.00-200.00", "brand": "adidas", "store_id": "01100002" } ``` {% endtab %} {% endtabs %} Usamos el método de integración síncrona [**Realtime**](/products/es/web-scraper-api/integration-methods/realtime.md) en nuestros ejemplos. Si deseas usar [**Proxy Endpoint**](/products/es/web-scraper-api/integration-methods/proxy-endpoint.md) o la integración asíncrona [**Push-Pull**](/products/es/web-scraper-api/integration-methods/push-pull.md) consulta la sección de [**métodos de integración**](/products/es/web-scraper-api/integration-methods.md) . ## Valores de los parámetros de solicitud ### Genérico Opciones básicas de configuración y personalización para extraer páginas de búsqueda de Kroger.
ParámetroDescripciónValor predeterminado
sourceEstablece el scraper.kroger_search
queryLa palabra clave o frase para buscar productos.-
renderHabilita el renderizado de JavaScript cuando se establece en html. Más información.-
callback_urlURL de tu endpoint de callback. Más información-
user_agent_typeTipo de dispositivo y navegador. La lista completa se puede encontrar aquí.desktop
\- parámetro obligatorio ### Localización Personalice los resultados según la ubicación de la tienda, las áreas de entrega y los métodos de cumplimiento preferidos.
ParámetroDescripciónValor predeterminadoDependencias
store_idEspecifique una tienda. Consulte los valores disponibles aquí. El ID debe comenzar con '0'.-Requerido cuando fulfillment_type está establecido en recogida o in_store.
delivery_zipEspecifique el código postal de la ubicación de entrega.-Requerido cuando fulfillment_type está establecido en entrega.
fulfillment_typeEspecifique el método de cumplimiento del pedido. Valores disponibles: recogida, entrega, in_store.recogida (si solo store_id se proporciona)Requiere store_id para recogida y in_store, o delivery_zip para entrega.
**Dependencias explicadas:** * `recogida` y `in_store` los valores usan el `store_id` parámetro para determinar la tienda correcta. * `entrega` 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 `recogida`. {% hint style="warning" %} Si la `fulfillment_type` y `store_id`/`delivery_zip` combinación no es válida (no es compatible con Kroger), la página extraída devolverá un estado 404. {% endhint %} ### Filtrado Opciones para filtrar y refinar los resultados de búsqueda según varios criterios.
ParámetroDescripciónValor predeterminado
price_rangeDefine el rango de precios deseado, con el formato min_price-max_price con dos decimales, separados por un guion (por ejemplo, 10.00-20.00).-
brandFiltra los resultados de búsqueda para incluir productos de una marca específica.-
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.oxylabs.io/api-targets/es/comercio-electronico/kroger/search.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.