Producto

Obtén detalles de productos de Best Buy, incluidos precios, valoraciones y especificaciones. Extrae datos analizados o HTML de forma eficiente.

La bestbuy_product la fuente está diseñada para recuperar páginas de resultados de productos de Bestbuy. Podemos devolver el HTML de cualquier página de Best Buy que desees. Además, podemos entregar salida estructurada (analizada) para páginas de productos de Best Buy.

Ejemplos de solicitud

Los ejemplos de abajo ilustran cómo puedes obtener un resultado analizado de un producto de Best Buy.

cURL

curl 'https://realtime.oxylabs.io/v1/queries' \\
--user 'USERNAME:PASSWORD' \\
-H 'Content-Type: application/json' \\
-d '{
        "source": "bestbuy_product", 
        "product_id": "6586591",
        "parse": true
    }'

Python

import requests
from pprint import pprint


# Estructura del payload.
payload = {
    'source': 'bestbuy_product',
    'product_id': '6586591',
    'parse': True
}

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

# Instead of response with job status and results url, this will return the
# JSON response with the result.
pprint(response.json())

Node.js

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "bestbuy_product",
    consulta: "6586591",
    parse: true
};

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

Toda la cadena que envíes debe estar codificada en URL.

https://realtime.oxylabs.io/v1/queries?source=bestbuy_product&product_id=6586591&parse=true&access_token=12345abcde

PHP

<?php

$params = array(
    'source' => 'bestbuy_product',
    'product_id' => '6586591',
    'parse' => true
);

$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":       "bestbuy_product",
		"product_id":   "6586591",
		"parse":        true
	}

	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))
}

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 = "bestbuy_product",
                product_id = "6586591",
                parse = true
            };

            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);
        }
    }
}

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", "bestbuy_product");
        jsonObject.put("product_id", "6586591");
        jsonObject.put("parse", true);

        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": "bestbuy_product", 
    "product_id": "6586591", 
    "parse": true
}

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

Parámetro	Descripción	Valor predeterminado
source	Configura el scraper.	universal
product_id	ID de producto de 7 caracteres.	-
render	Habilita el renderizado de JavaScript cuando se establece en html. Más información.	-
parse	Devuelve datos analizados cuando se establece en true. Explorar la salida diccionario de datos.	false
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

Adapta los resultados a dominios, tiendas y ubicaciones de entrega específicas.

Parámetro	Descripción	Valor predeterminado	Tipo
domain	Localización por dominio para Bestbuy. Valores disponibles: com, ca.	com	cadena
store_id	Especifica una tienda.	-	Entero
delivery_zip	Establece la ubicación ZIP de entrega.	-	cadena

E-Commerce Scraper API puede extraer resultados de productos de Best Buy en formato HTML o JSON, proporcionando datos estructurados sobre varios elementos de la página.

Ejemplo de salida

{
    "results": [
        {
            "content": {
                "url": "https://www.bestbuy.com/site/apple-iphone-15-plus-128gb-black-verizon/6525454.p?skuId=6525454&intl=nosplash",
                "price": {
                    "price": 25.83,
                    "currency": "USD"
                },
                "title": "Apple - iPhone 15 Plus 128GB - Negro (Verizon)",
                "rating": {
                    "count": 55,
                    "score": 4.3
                },
                "_errors": [
                    "'NoneType' object has no attribute 'xpath'"
                ],
                "product_id": "6525410",
                "is_sold_out": false,
                "parse_status_code": 12004,
            },
            "created_at": "2024-06-13 11:44:20",
            "updated_at": "2024-06-13 11:44:48",
            "page": 1,
            "url": "https://www.bestbuy.com/site/apple-iphone-15-plus-128gb-black-verizon/6525454.p?skuId=6525454&intl=nosplash",
            "job_id": "7206984735770310657",
            "status_code": 200,
            "parser_type": "bestbuy_product"
        }
    ]
}

Diccionario de datos de salida

Ejemplo en HTML

Estructura JSON

La tabla de abajo presenta una lista detallada de cada elemento de la página de producto que analizamos, junto con su descripción y tipo de dato. La tabla también incluye algunos metadatos.

Clave	Descripción	Tipo
url	La URL de la página de producto de Best Buy.	cadena
precio	El objeto de precio, que contiene información sobre el precio y la moneda.	objeto
price.price	El precio del producto.	flotante
price.currency	La moneda en la que está expresado el precio.	cadena
title	El título del producto.	cadena
rating	El objeto de valoración, que contiene cantidad y puntuación de las valoraciones.	objeto
rating.count	El número de valoraciones recibidas para el producto.	entero
rating.score	La puntuación de valoración del producto.	entero
product_id	El identificador único del producto.	cadena
is_sold_out	Indica si el producto está agotado.	booleano
parse_status_code	El código de estado del trabajo de análisis. Puedes ver los códigos de estado del parser descritos aquí.	entero
creado_en	La marca de tiempo en que se creó el trabajo de scraping.	marca_de_tiempo
actualizado_en	La marca de tiempo en que terminó el trabajo de scraping.	marca_de_tiempo
page	El número de página en la paginación de resultados.	entero
código_de_estado	El código de estado del trabajo de scraping. Puedes ver los códigos de estado del scraper descritos aquí.	entero
parser_type	El tipo de analizador usado para extraer los datos.	entero
id_del_trabajo	El ID del trabajo asociado con el trabajo de scraping.	cadena