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, breadcrumbs y más.

El 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 desees. Además, podemos entregar salida estructurada (analizada) para páginas de productos de Walmart.

Ejemplos de solicitud

El siguiente ejemplo ilustra cómo puedes obtener un resultado analizado 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 la carga útil.
payload = {
    'source': 'walmart_product',
    'product_id': '15296401808',
    'parse': True,
}

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

# En lugar de una respuesta con el estado del trabajo y la URL de resultados, esto devolverá la
# respuesta JSON con el resultado.
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();
    }
}

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

Valores de los parámetros de solicitud

Genérico

Parámetro

Descripción

Valor predeterminado

source

Establece el scraper.

walmart_product

product_id

ID de 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 de 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 de Walmart aquí:

294KB

www_walmart_com_stores.csv

Abrir

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

Parámetro

Descripción

Tipo

dominio

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

Cadena

fulfillment_type

Establece el tipo de cumplimiento. Los valores admitidos: recogida, entrega, shipping.

Cadena

delivery_zip

Establece la ubicación de 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 admitidos

walmart.com

recogida, entrega, shipping

walmart.com.mx

recogida, entrega

walmart.ca

recogida, entrega

walmart.co.cr

recogida

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

38KB

www_walmart_com_mx_stores.csv

Abrir

24KB

www_walmart_ca_stores.csv

Abrir

126B

walmart_co_cr_stores.json

Abrir

Si la tienda objetivo está demasiado lejos del código postal dado, intentaremos usar el código postal de la tienda objetivo; 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 orientación por tienda.

Datos estructurados

En las siguientes secciones, los fragmentos de código JSON analizados están abreviados 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": "Más vendido",
                    "brand": "Apple",
                    "title": "Apple iPhone XS usado - desbloqueado para operador - 64GB dorado",
                    "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 encanta 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, en cualquier dispositivo Apple. Un nuevo nivel de resistencia al agua. El vidrio más duradero en 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 experimentas fotos, juegos, 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 ayudar a convertir tus fotos en algo impactante. Seguridad hecha simple. 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 True Depth, el Secure Enclave y el Neural Engine— lo convierten en la autenticación facial más segura jamás vista en un smartphone. Y además, más rápida y fácil de usar.</p><ul>   <li>El teléfono ha sido probado, funciona y está operativo. Puede tener desgaste, rayones, grietas u otros problemas menores que no afectan la funcionalidad del teléfono.</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, Apple GPU (gráficos de 4 núcleos)</li>   <li>Cámaras duales de 12 MP (f/1.8, 28 mm, OIS) y 12 MP (f/2.4, 52 mm, zoom óptico 2x) con flash cuádruple LED de doble tono y cámara frontal de 7 MP con f/2.2, 32 mm</li>   <li>Memoria interna: 64GB, 4GB de RAM</li>   <li>Resistente al polvo y al agua IP68 (hasta 2 m durante 30 min), vidrio resistente a rayones, recubrimiento 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": "Titanio desierto"
                            }
                        ]
                    },
                "breadcrumbs": [
                    {
                        "url": "/cp/cell-phones/1105910",
                        "category_name": "Teléfonos móviles"
                    },
                    {
                        "url": "/cp/unlocked-phones/1073085",
                        "category_name": "Teléfonos desbloqueados"
                    },
                    {
                        "url": "/cp/gsm-unlocked/8230659",
                        "category_name": "GSM desbloqueados"
                    }
                ],
                "fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Recogida, no disponible",
                    "delivery_information": "Entrega, no disponible",
                    "shipping_information": "Envío, llega el 18 de oct., gratis"
                },
                "specifications": [
                    {
                        "key": "Processor Brand",
                        "value": "Apple"
                    },
                    {
                        "key": "Display Technology",
                        "value": "Pantalla Retina"
                    },
                    {
                        "key": "Phone Feature",
                        "value": "Carga inalámbrica"
                    },
                    ...
                ],
                "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 HTML

Estructura JSON

La tabla a continuación presenta una lista detallada de cada elemento de la página del 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.

object

price

El objeto contiene detalles sobre el precio del producto.

object

rating

Información de valoración del producto.

object

seller

Información sobre el vendedor.

object

variations (opcional)

Lista de variaciones del producto.

array

breadcrumbs

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

object

ubicación

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

object

fulfillment

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

object

specifications

Matriz de pares clave-valor que detalla atributos o características específicas del producto.

array

parse_status_code

El código de estado del trabajo de análisis. Puedes ver los códigos de estado del analizador descritos aquí.

integer

created_at

La marca de tiempo cuando se creó el trabajo de scraping.

timestamp

updated_at

La marca de tiempo cuando terminó el trabajo de scraping.

timestamp

page

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

integer

url

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

string

job_id

El ID del trabajo asociado con el trabajo de scraping.

string

status_code

El código de estado del trabajo de scraping. Puedes ver los códigos de estado del scraper descritos aquí.

integer

is_render_forced

Identifica si se ha forzado el renderizado para esta solicitud.

booleano

parser_type

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

string

General

Clave (general)

Descripción

Tipo

url

La URL del producto.

string

main_image

La URL de la imagen principal del producto

integer

images

Matriz de URLs de imágenes del producto.

array

title

Título o nombre del producto.

string

description

Descripción detallada del producto.

string

brand

La marca del producto.

string

badge

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

lista de cadenas

meta

Metadatos del producto.

object

meta.sku

Unidad de mantenimiento de stock (SKU) del producto.

string

meta.gtin

Número Global de Artículo Comercial (GTIN) del producto.

string

Precio

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

Clave (precio)

Descripción

Tipo

price

El precio actual del producto sin deducciones.

float

price_strikethrough

El precio tachado puede ser un precio anterior, un precio de paquete o un precio de lista.

float

moneda

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

string

Valoración

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

Clave (valoración)

Descripción

Tipo

rating

Valoración media del producto.

float

count

Número de valoraciones del producto.

integer

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

name

Nombre del vendedor.

string

official_name

Nombre oficial registrado de la entidad vendedora.

string

id

Identificador único asignado al vendedor por la plataforma.

string

url

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

string

catalog_id

ID del catálogo.

string

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.

string

valor

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

string

Cumplimiento

...
"fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Recogida, no disponible",
                    "delivery_information": "Entrega, no disponible",
                    "shipping_information": "Envío, llega el 24 de oct., gratis"
                },
...

Clave (cumplimiento)

Descripción

Tipo

recogida

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

booleano

pickup_information

El mensaje de recogida, cuando pickup = true.

string

entrega

Indica si el producto está disponible para ser entregado mediante envío desde la tienda local.

booleano

delivery_information

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

string

shipping

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

booleano

shipping_information

El mensaje de envío, si se muestra.

string

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": "Negro"
            },
]
...

Clave (variations)

Descripción

Tipo

state

Estado de disponibilidad de la variación del producto.

string

product_id

Identificador único para cada variación del producto.

string

selected_options

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

array

selected_options.key

Clave que describe la opción seleccionada.

string

selected_options.value

Valor de la opción seleccionada.

string

Breadcrumbs

... 
"breadcrumbs": [
    {
        "url": "/cp/cell-phones/1105910",
        "category_name": "Teléfonos móviles"
    },
    {
        "url": "/cp/phones-with-plans/1073085",
        "category_name": "Teléfonos con plan"
    },
    {
        "url": "/cp/postpaid-phones/8230659",
        "category_name": "Teléfonos pospago"
    }
    ...
],
...

Clave (breadcrumbs)

Descripción

Tipo

category_name

El nombre de la categoría.

string

url

La URL de la categoría

string

Ubicación

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

Clave (ubicación)

Descripción

Tipo

city

La ciudad en la que se ejecutó la solicitud.

string

state

El estado en el que se ejecutó la solicitud.

string

zip_code

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

string

store_id

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

string

AnteriorBúsqueda SiguienteURL

Última actualización hace 1 mes

¿Te fue útil?