Producto

Extrae páginas de producto de Walmart por ID de producto con datos parseados 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. Adicionalmente, podemos entregar salida estructurada (analizada) para páginas de productos de Walmart.

Ejemplos de solicitudes

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

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


# Estructurar la carga.
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,
)

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

<?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 Realtime síncrono en nuestros ejemplos. Si desea usar Proxy Endpoint o asincrónico Push-Pull para la integración, consulte la página de métodos de integración sección.

Valores de los parámetros de la solicitud

Genérico

Parámetro

Descripción

Valor predeterminado

source

Establece el scraper.

walmart_product

product_id

ID de producto de Walmart.

render

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

parse

Devuelve datos parseados cuando se establece en true.

false

callback_url

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

user_agent_type

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

escritorio

- parámetro obligatorio

Localización

Adaptar los resultados a tiendas específicas y ubicaciones de envío. Encuentra la lista en formato JSON de IDs de tiendas Walmart aquí:

7MB

walmart_nodes.json

Abrir

También puede encontrar la página oficial de Tiendas Walmart aquí.

Parámetro

Descripción

Tipo

domain

Localización de dominio para Walmart.

String

delivery_zip

Establece el envío a la ubicación.

String

store_id

Establece la ubicación de la tienda.

String

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

Datos estructurados

En las secciones siguientes, los fragmentos de código JSON analizados se acortan cuando hay más de un artículo 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 totalmente pantalla te ofrece un lienzo grande y hermoso para todo lo que te gusta hacer. OLED construido a medida. Los paneles OLED del iPhone Xs permiten una pantalla HDR con la mejor precisión de color de la industria, negros verdaderos 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 una banda de acero inoxidable de grado quirúrgico, ayuda a crear una carcasa más resistente al agua: hasta 2 metros por 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 motor neuronal 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 sistema de cámara dual innovador integra el ISP, el motor neuronal y algoritmos avanzados para desbloquear nuevas posibilidades creativas y ayudarte a capturar fotos increíbles. Una imagen vale billones de operaciones. El sistema de cámara dual del iPhone Xs aprovecha el poder sin precedentes del motor neuronal y su capacidad para realizar cinco billones de operaciones por segundo. Junto con el ISP diseñado por Apple, funciona como el asistente de fotógrafo más rápido del mundo para ayudar a convertir tus fotos en piezas destacadas. 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 True Depth, el Secure Enclave y el motor neuronal, 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 está probado, funcionando y operativo. Puede tener marcas, arañazos, 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 12MP(f/1.8, 28mm, OIS) y 12MP(f/2.4, 52mm, Zoom óptico 2x) con flash Quad-LED de doble tono 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 2 m por 30 min), vidrio resistente a arañazos, 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": "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 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 de producto.

object

price

El objeto contiene detalles sobre el precio del producto.

object

rating

Información de calificación para el 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

location

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

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

array

parse_status_code

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

integer

created_at

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

timestamp

updated_at

La marca temporal cuando se finalizó el trabajo de scraping.

timestamp

página

Número de página desde la cual 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. Puede ver los códigos de estado del scraper descritos aquí.

integer

is_render_forced

Identifica si el renderizado ha sido forzado para esta solicitud.

boolean

parser_type

Tipo de parser usado para extraer los datos (p. ej., "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

Array 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 strings

meta

Metadatos del producto.

object

meta.sku

Unidad de mantenimiento de existencias (SKU) del producto.

string

meta.gtin

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

string

Price

...
"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 es o bien un precio anterior (Was Price), un precio de paquete (Bundle Price) o un precio de lista (List Price).

float

currency

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

string

Rating

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

Clave (rating)

Descripción

Tipo

rating

Calificación promedio del producto.

float

count

Número de valoraciones del producto.

integer

Seller

...
"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 (seller)

Descripción

Tipo

nombre

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 oficial o escaparate del vendedor.

string

catalog_id

ID del catálogo.

string

Specifications

...
"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

value

Valor correspondiente o descripción 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": "Pickup, Not available",
                    "delivery_information": "Delivery, Not available",
                    "shipping_information": "Shipping, Arrives Oct 24, Free"
                },
...

Clave (cumplimiento)

Descripción

Tipo

recogida

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

boolean

pickup_information

El mensaje de recogida, cuando pickup = true.

string

entrega

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

boolean

delivery_information

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

string

envío

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

boolean

shipping_information

El mensaje de envío, si se muestra.

string

envío_gratuito

Indica si el envío es gratuito.

boolean

out_of_stock

Indica si el producto está actualmente agotado.

boolean

Variations

...
"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.

string

product_id

Identificador único para cada variación del producto.

string

selected_options

Array 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": "Cell Phones"
    },
    {
        "url": "/cp/phones-with-plans/1073085",
        "category_name": "Phones With Plans"
    },
    {
        "url": "/cp/postpaid-phones/8230659",
        "category_name": "Postpaid Phones"
    }
    ...
],
...

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

ciudad

La ciudad en la que se ejecutó la solicitud.

string

estado

El estado en el que se ejecutó la solicitud.

string

código_postal

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 5 horas

¿Te fue útil?

Buenas tardes

hashtagEjemplos de solicitudes

hashtagValores de los parámetros de la solicitud

hashtagGenérico

hashtagLocalización

hashtagDatos estructurados

hashtagDiccionario de datos de salida

hashtagEjemplo HTML

hashtagGeneral

hashtagPrice

hashtagRating

hashtagSeller

hashtagSpecifications

hashtagCumplimiento

hashtagVariations

hashtagBreadcrumbs

hashtagUbicación

Ejemplos de solicitudes

Valores de los parámetros de la solicitud

Genérico

Localización

Datos estructurados

Diccionario de datos de salida

Ejemplo HTML

General

Price

Rating

Seller

Specifications

Cumplimiento

Variations

Breadcrumbs

Ubicación