Producto

Extrae páginas de producto de Walmart por ID de producto con datos analizados que incluyen precios, valoraciones, información del vendedor, especificaciones, variaciones, opciones de cumplimiento, migas de pan y más.

La walmart_product source está diseñado para recuperar páginas de resultados de productos de Walmart. Podemos devolver el HTML de cualquier página de Walmart que quieras. Además, podemos entregar salida estructurada (parseada) para páginas de producto de Walmart.

Ejemplos de solicitud

El ejemplo a continuación ilustra cómo puedes obtener un resultado parseado de una página de producto de Walmart.

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

import requests
from pprint import pprint


# Estructura del payload.
payload = {
    'source': 'walmart_product',
    'product_id': '15296401808',
    '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())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "walmart_product",
    product_id: "15296401808",
    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();

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

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

<?php

$params = array(
    'source' => 'walmart_product',
    'product_id' => '15296401808',
    '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);

package main

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

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

	payload := map[string]interface{}{
		"source":       "walmart_product",
		"product_id":   "15296401808",
		"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))
}

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 = "walmart_product",
                product_id = "15296401808",
                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);
        }
    }
}

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", "walmart_product");
        jsonObject.put("product_id", "15296401808");
        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();
    }
}

{
    "source": "walmart_product", 
    "product_id": "15296401808", 
    "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.

walmart_product

product_id

ID del producto de Walmart.

render

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

parse

Devuelve datos analizados cuando se establece en true.

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 tiendas específicas y ubicaciones de envío. Encuentra la lista de IDs de tiendas Walmart aquí:

www_walmart_com_stores.csv

294KB

Abrir

También puedes encontrar la página oficial de Walmart Stores aquí.

Parámetro

Descripción

Tipo

domain

Localización de dominio para Walmart. Valores disponibles: com, com.mx, ca, co.cr. Valor predeterminado: com.

cadena

fulfillment_type

Establece el tipo de cumplimiento. Valores compatibles: pickup, delivery, envío.

cadena

delivery_zip

Establece la ubicación de destino del envío.

cadena

store_id

Establece la ubicación de la tienda.

cadena

La disponibilidad del parámetro de tipo de cumplimiento varía según el dominio de Walmart:

Dominio

Tipos de cumplimiento compatibles

walmart.com

pickup, delivery, envío

walmart.com.mx

pickup, delivery

walmart.ca

pickup, delivery

walmart.co.cr

pickup

Para las listas internacionales store_id consulta los archivos a continuación:

www_walmart_com_mx_stores.csv

38KB

Abrir

www_walmart_ca_stores.csv

24KB

Abrir

walmart_co_cr_stores.json

126B

Abrir

Si la tienda de destino está demasiado lejos del código postal proporcionado, intentaremos usar el código postal de la tienda de destino; de lo contrario, la ubicación no se establecerá correctamente. En caso de que no podamos establecer la delivery_zip - Walmart devolverá sus resultados predeterminados sin segmentación por tienda.

Datos estructurados

En las siguientes secciones, los fragmentos de código JSON analizados se acortan cuando hay más de un elemento disponible para el tipo de resultado.

Salida estructurada de la página de producto de Walmart

{
    "results": [
        {
            "content": {
                "price": {
                    "price": 157.97,
                    "currency": "USD",
                    "price_strikethrough": 199.99
                },
                "rating": {
                    "count": 94,
                    "rating": 4.5
                },
                "seller": {
                    "id": "ED6F630F4BA94318A00A1D0BAACD0A48",
                    "url": "/seller/7648?itemId=701606028&pageName=item&returnUrl=%2Fip%2FApple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional%2F701606028",
                    "name": "Kiss Electronics Inc",
                    "catalog_id": "7648",
                    "official_name": "Kiss Electronics Inc"
                },
                "general": {
                    "url": "https://www.walmart.com/ip/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional/701606028",
                    "meta": {
                        "sku": "701606028",
                        "gtin": "683346585136"
                    },
                    "badge": "Best seller",
                    "brand": "Apple",
                    "title": "Pre-Owned Apple iPhone XS - Carrier Unlocked - 64GB Gold",
                    "images": [
                        "https://i5.walmartimages.com/seo/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional_d6dacc88-10c1-46e0-b528-c626915adadc.4c6907ee5896ccbc68382cb59470a6d8.jpeg?odnHeight=117&odnWidth=117&odnBg=FFFFFF"
                    ],
                    "main_image": "https://i5.walmartimages.com/seo/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional_d6dacc88-10c1-46e0-b528-c626915adadc.4c6907ee5896ccbc68382cb59470a6d8.jpeg?odnHeight=640&odnWidth=640&odnBg=FFFFFF",
                    "description": "<p>Super Retina. En grande y más grande. Un diseño de pantalla completa te ofrece un lienzo grande y hermoso para todo lo que te gusta hacer. OLED diseñado a medida. Los paneles OLED del iPhone Xs permiten una pantalla HDR con la mejor precisión de color de la industria, negros reales y un brillo y contraste notables. Son las pantallas más nítidas, con la mayor densidad de píxeles, de cualquier dispositivo Apple. Un nuevo nivel de resistencia al agua. El vidrio más duradero de un smartphone, sellado y ajustado con precisión con una banda de acero inoxidable de grado quirúrgico, ayuda a crear una carcasa más resistente al agua, hasta 2 metros durante 30 minutos. El iPhone Xs incluso resiste derrames de café, té, refrescos y más. Un nivel completamente nuevo de inteligencia. El A12 Bionic, con nuestro Neural Engine de próxima generación, ofrece un rendimiento increíble. Usa aprendizaje automático en tiempo real para transformar la forma en que vives las fotos, los juegos, la realidad aumentada y más. Sensores, procesadores, algoritmos y tú. Un innovador sistema de doble cámara integra el ISP, el Neural Engine y algoritmos avanzados para desbloquear nuevas posibilidades creativas y ayudarte a capturar fotos increíbles. Una imagen vale un billón de operaciones. El sistema de doble cámara del iPhone Xs aprovecha el poder sin precedentes del Neural Engine y su capacidad para realizar cinco billones de operaciones por segundo. Junto con el ISP diseñado por Apple, funciona como el asistente fotográfico más rápido del mundo para ayudarte a convertir tus fotos en protagonistas. La seguridad, simplificada. Face ID reinventa la forma en que desbloqueamos, iniciamos sesión y pagamos. Algunas de nuestras tecnologías más sofisticadas —el sistema de cámara TrueDepth, Secure Enclave y Neural Engine— lo convierten en la autenticación facial más segura jamás vista en un smartphone. Y además, es más rápido y fácil de usar.</p><ul>   <li>El teléfono ha sido probado, funciona y es operativo. Puede presentar desgaste, rayones, grietas u otros problemas menores que no afectan su funcionamiento.</li>   <li>Pantalla táctil capacitiva Super AMOLED de 5.8 pulgadas, 1125 x 2436 píxeles</li>   <li>iOS, Apple A12 Bionic, Hexa-Core, GPU de Apple (gráficos de 4 núcleos)</li>   <li>Cámaras duales de 12MP(f/1.8, 28mm, OIS) &amp; 12MP(f/2.4, 52mm, 2x optical Zoom) con flash dual de tono Quad-LED y cámara frontal de 7MP con f/2.2, 32mm</li>   <li>Memoria interna: 64GB, 4GB RAM</li>   <li>Resistente al polvo/agua IP68 (hasta 2m durante 30 mins), vidrio resistente a los arañazos, revestimiento oleofóbico</li>   <li>Dimensiones: 5.65 x 2.79 x 0.30 pulgadas, Peso: 6.24 oz</li>  </ul>"
                },
                "location": {
                    "city": "Sacramento",
                    "state": "CA",
                    "store_id": "3081",
                    "zip_code": "95829"
                },
                 "variations": [
                    {
                        "state": "IN_STOCK",
                        "product_id": "7328JAQF0Y2S",
                        "selected_options": [
                            {
                                "key": "Carrier",
                                "value": "Verizon"
                            },
                            {
                                "key": "Capacity",
                                "value": "256GB"
                            },
                            {
                                "key": "Color",
                                "value": "Desert Titanium"
                            }
                        ]
                    },
                "breadcrumbs": [
                    {
                        "url": "/cp/cell-phones/1105910",
                        "category_name": "Cell Phones"
                    },
                    {
                        "url": "/cp/unlocked-phones/1073085",
                        "category_name": "Unlocked Phones"
                    },
                    {
                        "url": "/cp/gsm-unlocked/8230659",
                        "category_name": "GSM Unlocked"
                    }
                ],
                "fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Pickup, Not available",
                    "delivery_information": "Delivery, Not available",
                    "shipping_information": "Shipping, Arrives Oct 18, Free"
                },
                "specifications": [
                    {
                        "key": "Processor Brand",
                        "value": "Apple"
                    },
                    {
                        "key": "Display Technology",
                        "value": "Retina Display"
                    },
                    {
                        "key": "Phone Feature",
                        "value": "Wireless Charging"
                    },
                    ...
                ],
                "parse_status_code": 12000
            },
            "created_at": "2024-09-16 08:09:03",
            "updated_at": "2024-09-16 08:09:06",
            "page": 1,
            "url": "https://www.walmart.com//ip/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional/701606028",
            "job_id": "7253339040034008521",
            "is_render_forced": false,
            "status_code": 200,
            "parser_type": "walmart_product_new"
        }
    ]
}

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

general

Un objeto con detalles generales del resultado de la página del producto.

objeto

precio

El objeto contiene detalles sobre el precio del producto.

objeto

rating

Información de calificación del producto.

objeto

vendedor

Información sobre el vendedor.

objeto

variaciones (opcional)

Lista de variaciones del producto.

arreglo

migas de navegación

Jerarquía de categorías que lleva al producto.

objeto

location

Proporciona información sobre la ubicación desde la que se ejecutó la solicitud.

objeto

cumplimiento

El objeto contiene información sobre las opciones de cumplimiento del producto.

objeto

especificaciones

Arreglo de pares clave-valor que detallan atributos o características específicos del producto.

arreglo

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

Número de página de la que se extrajeron los datos del producto

entero

url

URL de la página del producto en el sitio web de Walmart

cadena

id_del_trabajo

El ID del trabajo asociado con el trabajo de scraping.

cadena

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

is_render_forced

Identifica si el renderizado se ha forzado para esta solicitud.

booleano

parser_type

Tipo de parser usado para extraer los datos (por ejemplo, "walmart_product_new").

cadena

General

Clave (general)

Descripción

Tipo

url

La URL del producto.

cadena

main_image

La URL de la imagen principal del producto

entero

images

Arreglo de URLs de las imágenes del producto.

arreglo

title

Título o nombre del producto.

cadena

description

Descripción detallada del producto.

cadena

marca

La marca del producto.

cadena

insignia

Indicador de atributos específicos como promociones, características del producto, certificaciones o afiliaciones de marca.

lista de cadenas

meta

Metadatos del producto.

objeto

meta.sku

Unidad de mantenimiento de stock (SKU) del producto.

cadena

meta.gtin

Número global de artículo comercial (GTIN) del producto.

cadena

Precio

...
"price": {
    "price": 12.49,
    "price_strikethrough": 23.72,
    "currency": "USD"
},
...

Clave (precio)

Descripción

Tipo

precio

El precio actual del producto sin descuentos.

flotante

precio_tachado

El precio tachado es, según corresponda, un precio anterior, un precio de paquete o un precio de lista.

flotante

moneda

El código de moneda de tres letras ISO 4217 para el precio del producto.

cadena

Calificación

...
 "rating": {
    "count": 64,
    "rating": 4.7
},
...

Clave (calificación)

Descripción

Tipo

rating

Calificación promedio del producto.

flotante

cantidad

Número de calificaciones del producto.

entero

Vendedor

...
"seller": {
    "id": "ED6F630F4BA94318A00A1D0BAACD0A48",
    "url": "/seller/7648?itemId=701606028&pageName=item&returnUrl=%2Fip%2FApple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional%2F701606028",
    "name": "Kiss Electronics Inc",
    "catalog_id": "7648",
    "official_name": "Kiss Electronics Inc"
},
...

Clave (vendedor)

Descripción

Tipo

nombre

Nombre del vendedor.

cadena

official_name

Nombre registrado oficial de la entidad vendedora.

cadena

id

Identificador único asignado al vendedor por la plataforma.

cadena

url

La URL que lleva al sitio web oficial o la tienda del vendedor.

cadena

catalog_id

ID del catálogo.

cadena

Especificaciones

...
"specifications": [
    ...
    {
        "key": "Brand",
        "value": "LEGO"
    },
    {
        "key": "Age Range",
        "value": "9 Years & Up"
    },
]
...

Clave (especificaciones)

Descripción

Tipo

key

Atributo o característica específica del producto.

cadena

valor

Valor o descripción correspondiente del atributo especificado por la clave de especificaciones.

cadena

Cumplimiento

...
"fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Pickup, Not available",
                    "delivery_information": "Delivery, Not available",
                    "shipping_information": "Shipping, Arrives Oct 24, Free"
                },
...

Clave (cumplimiento)

Descripción

Tipo

pickup

Indica si el producto está disponible para cumplimiento mediante recogida en tienda.

booleano

pickup_information

El mensaje de recogida, cuando pickup = true.

cadena

delivery

Indica si el producto está disponible para cumplimiento mediante entrega desde una tienda local.

booleano

delivery_information

El mensaje de entrega desde una tienda local, cuando delivery = true.

cadena

envío

Indica si el producto está disponible para cumplimiento mediante envío a domicilio.

booleano

shipping_information

El mensaje de envío, si se muestra.

cadena

free_shipping

Indica si el envío es gratuito.

booleano

out_of_stock

Indica si el producto está actualmente agotado.

booleano

Variaciones

...
"variations": [
    {
        "state": "IN_STOCK",
        "product_id": "7328JAQF0Y2S",
        "selected_options": [
            {
                "key": "Color",
                "value": "Black"
            },
]
...

Clave (variaciones)

Descripción

Tipo

estado

Estado de disponibilidad de la variación del producto.

cadena

product_id

Identificador único de cada variación del producto.

cadena

selected_options

Arreglo que contiene las opciones seleccionadas que definen la variación.

arreglo

selected_options.key

Clave que describe la opción seleccionada.

cadena

selected_options.value

Valor de la opción seleccionada.

cadena

Migas de navegación

... 
"breadcrumbs": [
    {
        "url": "/cp/cell-phones/1105910",
        "category_name": "Cell Phones"
    },
    {
        "url": "/cp/phones-with-plans/1073085",
        "category_name": "Phones With Plans"
    },
    {
        "url": "/cp/postpaid-phones/8230659",
        "category_name": "Postpaid Phones"
    }
    ...
],
...

Clave (migas de navegación)

Descripción

Tipo

category_name

El nombre de la categoría.

cadena

url

La URL de la categoría

cadena

Ubicación

...
"location": {
    "city": "Sacramento",
    "state": "CA",
    "store_id": "8915",
    "zip_code": "95829"
},
...

Clave (ubicación)

Descripción

Tipo

ciudad

La ciudad desde la que se ejecutó la solicitud.

cadena

estado

El estado desde el que se ejecutó la solicitud.

cadena

código postal

El código postal desde el que se ejecutó la solicitud.

cadena

store_id

El ID de la tienda desde la que se ejecutó la solicitud.

cadena

AnteriorBúsqueda

SiguienteURL

Última actualización hace 20 días

¿Te fue útil?