Entidad estable
Identidad del producto
Marca, modelo, título canónico, categorías, identificadores, descripciones, atributos y medios.
- ASIN / SKU / GTIN / MPN
- Brand & model
- Category & attributes
Productos, precios y reseñas
Recopila productos, precios, promociones, existencias, vendedores y reseñas para análisis minorista. Elige APIs de comercio estructuradas, conjuntos de datos o feeds periódicos.
Modelo de registro comercial
Separar la identidad de las observaciones que cambian según el vendedor, ubicación, página y tiempo. El resultado es más fácil de comparar, actualizar y gobernar.
Entidad estable
Marca, modelo, título canónico, categorías, identificadores, descripciones, atributos y medios.
Configuración
Tamaño, color, capacidad, unidad, paquete, estilo u otra configuración definida por la fuente de un producto.
Observación limitada en el tiempo
Precio, precio de lista, promoción, condición, disponibilidad, envío, recogida y contexto de cumplimiento.
Entidad del mercado
La identidad del comerciante público y el contexto de la tienda se mantienen separados del producto y se le ofrecen suministros.
El feedback público
Reuniendo las calificaciones, las distribuciones, los recuentos y los campos de nivel de revisión donde el punto final o el alcance seleccionado los respalde.
Cobertura de la fuente
Revisa la fuente, el tipo de página, el mercado y los campos que necesitas antes de elegir una API o una recopilación personalizada.
La documentación actual enumera las APIs de mercado y minoristas con contratos de solicitud y respuesta específicos de la fuente.
Las fuentes de venta al por menor, mercado, marca, comparación y revisión se evalúan con páginas representativas antes de un compromiso recurrente.
Los datos de cuentas privadas, carros, facturación o clientes están fuera del alcance de la web pública estándar.
Campos y registros de ejemplo
Comience desde los campos que necesita su sistema, luego mapee los valores de origen, módulos opcionales, identificadores y estados de calidad en un esquema documentado.
product_id · source_product_id · brand · title · category · attributes · media
variant_id · parent_id · size · color · unit · pack_quantity · option_labels
current_price · list_price · currency · promotion · condition · seller_id
availability_text · normalized_state · shipping · pickup · delivery_window
rating · rating_count · review_count · distribution · review_items
source_url · observed_at · requested_context · collection_state · schema_version
{
"record_id": "obs_001",
"schema_version": "commerce.v1",
"product": {
"source_product_id": "DEMO-128",
"brand": "Example",
"title": "Wireless headphones",
"variant": { "color": "black" }
},
"offer": {
"current_price": 79.00,
"list_price": 99.00,
"currency": "USD",
"availability_text": "In stock"
},
"rating": {
"value": 4.6,
"count": 1248
},
"source_url": "https://retailer.example/p/001",
"observed_at": "YYYY-MM-DDThh:mm:ssZ",
"collection_state": "observed"
}Identidad y coincidencia
Mantenga la observación original, luego añada una capa de identidad contraída sólo cuando la comparación sea explicable y testable.
Frescos y historia
Especifique cuándo se debe ejecutar la recopilación, qué timestamp tiene un registro y qué cambios deben convertirse en historia en lugar de valores sobrescritos.
En el momento de la solicitud
No sincronizado
Programación
Los puntos de longitud
Calidad y falta
La calidad no es un porcentaje de precisión, sino un conjunto de controles acordados y estados observables adjuntos al campo, registro, fuente y entrega.
The supported field or object was returned in the requested context.
Use with timestamp and sourceThe page was collected, but the selected module or field was not displayed.
Keep distinct from zeroThe page or object was not available in the requested public context.
Do not infer inventoryThe collection event did not produce a usable page or supported response.
Retry or escalate by contractA value did not meet the agreed structure, type, or parsing rule.
Quarantine with reasonIdentity cues were incomplete, conflicting, or below the agreed threshold.
Keep source record availableOpciones de entrega
Proxies
Ideal para · Equipos con sistemas de recopilación existentes.
Explore Infraestructura de proxies¿Qué equipos construyen
Usa los campos y ejemplos siguientes para planificar tu análisis, producto o flujo de seguimiento.
Pilotante representativo
Un piloto útil prueba las combinaciones de fuentes y campos más difíciles, no sólo las páginas de productos más limpias.
Breve
Muestra
Contrato
Entrega de dinero
Preguntas comunes
Recopila productos, precios, promociones, existencias, vendedores y reseñas para análisis minorista. Elige APIs de comercio estructuradas, conjuntos de datos o feeds periódicos.
Explora APIs de comercio para Amazon, Walmart, eBay y otros minoristas compatibles. Cada página de fuente muestra los tipos de página y campos que puedes comprobar en una muestra.
Las calificaciones, recuentos de revisiones, distribuciones de calificaciones o extractos de revisiones se documentan para puntos finales de productos seleccionados y también se pueden evaluar en un programa de datos de alcance. Los campos de revisión varían según la fuente y el tipo de página, y un resumen de calificación no debe presentarse como cobertura completa de revisión a menos que esa cobertura sea verificada.
El modelo de datos mantiene la identidad del producto estable separada de las variantes de la fuente, las ofertas limitadas en el tiempo, el contexto del vendedor y las observaciones de revisión. Cada objeto puede conservar su URL de origen, identificador de fuente, contexto solicitado, tiempo de observación y estado de recopilación para que los equipos en aguas subyacentes puedan unir los registros sin borrar de dónde provenían.
La correspondencia puede incluirse en un feed o programa gestionado. La muestra confirma identificadores, reglas de comparación y cómo se muestran coincidencias inciertas o contradictorias.
Las APIs recopilan datos cuando se las llama. Los feeds y Managed Data siguen un calendario acordado y separan las marcas de tiempo de origen y recopilación cuando están disponibles.
El historial empieza al iniciar el seguimiento. La cobertura anterior depende de registros de origen o capturas de archivo disponibles. Revisa fechas y lagunas en una muestra.
La muestra distingue campos ausentes, páginas no disponibles, solicitudes fallidas y valores que requieren revisión. Acuerda el tratamiento de cada estado antes de la entrega periódica.
Tu equipo mantiene los sistemas de recopilación con proxies y los parsers propios con APIs de acceso a páginas. Nosotros mantenemos la extracción compatible de Data API y la recopilación incluida en feeds o Managed Data.
El alcance se limita a las páginas web públicas elegibles y a los campos públicos acordados. Los datos de cuenta privada, carrito, caja, pedido y cliente no son el alcance estándar. Los clientes siguen siendo responsables del uso legal, la retención, los controles de acceso y los precios, la comercialización, la ejecución u otras decisiones tomadas con los datos entregados.
Productos, precios y reseñas
Utilice una API de comercio documentada en su propio flujo de trabajo, o muestre las fuentes, campos, contexto y ventana de actualización que su equipo necesita entregar.