Producto

Extrae páginas de productos 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 la fuente está diseñada para recuperar las 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 útil.
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
# JSON de respuesta 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 síncrono Realtime en nuestros ejemplos. Si desea usar Proxy Endpoint o la integración asíncrona Push-Pull consulte los métodos de integración sección.

Valores de 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 la renderización 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 su 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

Adaptar resultados a tiendas específicas, ubicaciones de envío. Encuentra la lista de IDs de tiendas de Walmart aquí:

294KB

www_walmart_com_stores.csv

Abrir

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

Parámetro

Descripción

Tipo

domain

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

String

fulfillment_type

Establezca el tipo de cumplimiento. Valores compatibles: pickup, delivery, shipping.

String

delivery_zip

Establece la ubicación de envío.

String

store_id

Establezca la ubicación de la tienda.

String

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, shipping

walmart.com.mx

pickup, delivery

walmart.ca

pickup, delivery

walmart.co.cr

pickup

Para listas internacionales, store_id consulte 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 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 elemento disponible para el tipo de resultado.

Salida estructurada de 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. In Big and Bigger. An all-screen design gives you a large, beautiful canvas for everything you love to do. Custom-built OLED. The OLED panels in iPhone Xs allow for an HDR display with the industry's best color accuracy, true blacks, and remarkable brightness and contrast. They're the sharpest displays, with the highest pixel density, on any Apple device. A new level of water resistance. The most durable glass in a smartphone, sealed and precision-fitted with surgical-grade stainless steel band, helps create a more water-resistant enclosure - up to 2 meters for 30 minutes. iPhone Xs even resists spills from Coffee, Tea, Soda, and more. A whole new level of intelligence. The A12 Bionic, with our next-generation Neural Engine, delivers incredible performance. It uses real-time machine learning to transform the way you experience photos, gaming, augmented reality, and more. Sensors, processors, algorithms, and you. An innovative dual-camera system integrates the ISP, the Neural Engine, and advanced algorithms to unlock new creative possibilities and help you capture incredible photos. A picture is worth a trillion operations. The iPhone Xs dual-camera system harnesses the unprecedented power of the Neural Engine and its ability to perform five trillion operations per second. Together with the Apple-designed ISP, it works like the world's fastest photographer's assistant to help turn your pictures into showstoppers. Security made simple. Face ID reinvent the way we unlock, log in, and pay. Some of our most sophisticated technologies - the True Depth camera system, the Secure Enclave, and the Neural Engine - make it the most secure facial authentication ever in a smartphone. And even faster and easier to use.</p><ul>   <li>Phone is tested, working and functional. May have scruff, scratched, cracks or other minor issues that don't affect the functionality of phone.</li>   <li>5.8-inch Super AMOLED Capacitive Touchscreen, 1125 x 2436 pixels</li>   <li>iOS, Apple A12 Bionic, Hexa-Core, Apple GPU (4-Core Graphics)</li>   <li>Dual 12MP(f/1.8, 28mm, OIS) &amp; 12MP(f/2.4, 52mm, 2x optical Zoom) Cameras with Quad-LED Dual-Tone Flash &amp; 7MP Front Camera with f/2.2, 32mm</li>   <li>Internal Memory: 64GB, 4GB RAM</li>   <li>IP68 Dust/Water Resistant (Up to 2m for 30 mins), Scratch-Resistant Glass, Oleophobic Coating</li>   <li>Dimensions: 5.65 x 2.79 x 0.30 inches, Weight: 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 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 de producto.

object

price

El objeto contiene detalles sobre el precio del producto.

object

rating

Información de calificación para el producto.

object

El vendedor del producto.

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 de tiempo cuando se creó el trabajo de scraping.

timestamp

updated_at

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

timestamp

page

Número de página desde el 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 se ha forzado la renderización para esta solicitud.

boolean

parser_type

Tipo de parser 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

Array de URLs a 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 ya sea 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
},
...

Key (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"
},
...

Key (seller)

Describtion

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 conduce al sitio web oficial o escaparate del vendedor.

string

catalog_id

ID de 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

Fulfillment

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

Key (fulfillment)

Descripción

Tipo

pickup

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

boolean

pickup_information

El mensaje de recogida, cuando pickup = true.

string

delivery

Indica si el producto está disponible para ser cumplido mediante entrega desde la tienda local.

boolean

delivery_information

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

string

shipping

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

boolean

shipping_information

El mensaje de envío, si se muestra.

string

free_shipping

Indica si el envío es gratuito.

boolean

out_of_stock

Indica si el producto actualmente está agotado.

boolean

Variations

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

Clave (variaciones)

Descripción

Tipo

state

Estado de disponibilidad de la variación del producto.

string

product_id

Identificador único para cada variación de producto.

string

selected_options

Array que contiene 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

Location

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

Key (location)

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 6 días

¿Te fue útil?

Buenas noches

hashtagEjemplos de solicitudes

hashtagValores de parámetros de solicitud

hashtagGenérico

hashtagLocalización

hashtagDatos estructurados

hashtagDiccionario de datos de salida

hashtagEjemplo HTML

hashtagGeneral

hashtagPrice

hashtagRating

hashtagSeller

hashtagSpecifications

hashtagFulfillment

hashtagVariations

hashtagBreadcrumbs

hashtagLocation

Ejemplos de solicitudes

Valores de parámetros de solicitud

Genérico

Localización

Datos estructurados

Diccionario de datos de salida

Ejemplo HTML

General

Price

Rating

Seller

Specifications

Fulfillment

Variations

Breadcrumbs

Location