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
Recoge productos públicos, variantes, ofertas, vendedores, calificaciones y observaciones de revisión a través de API de comercio documentadas, o recibe un conjunto de datos mantenido en forma alrededor de sus fuentes, campos, contexto y cadencia.
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
Un logotipo de origen no es una garantía de campo. Evaluar el punto final, el tipo de página, las entradas de solicitud, los campos de respuesta y los estados que faltan que importan para su flujo de trabajo.
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.
Contrato de campo
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 · marca · título · categoría · atributos · medios
variante_id · parente_id · tamaño · color · unidad · paquete_cantidad · opciones_etiquetas
precio actual · lista_precio · moneda · promoción · condición · vendedor_id
disponibilidad_texto · normalizado_estado · envío · recogida · entrega_ventana
rating · rating_count · review_count · distribución · review_items
fuente_url · observado_en · solicitado_contexto · colección_estado · esquema_versión
{
"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"
}A displayed price is an observation, not a checkout total. Displayed availability is not an inventory guarantee.
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.
Tiempo de 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 availableModelo de operación
Control máximo de la pila
Best fit · Teams with established commerce-data engineering and a requirement to control collection and schema logic.
Explore proxy infrastructureEn cada modelo, el cliente conserva los precios, la comercialización, la aplicación y las decisiones posteriores. WebScrapingAPI proporciona acceso, observaciones estructuradas o entrega operativa de acuerdo con el producto y el contrato seleccionados.
¿Qué equipos construyen
Los mismos objetos vinculados a la fuente pueden apoyar a múltiples equipos sin pretender que la observación recopilada tome la decisión comercial.
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
Pregunta frecuente sobre la evaluación
Estas respuestas definen los límites de responsabilidad y producto que los compradores deben evaluar.
Dependiendo del punto final documentado o del alcance de la fuente acordado, los registros pueden incluir identificadores de productos, títulos, marcas, categorías, atributos, variantes, imágenes, precios mostrados, promociones, vendedores, disponibilidad visible, detalles de cumplimiento, calificaciones, recuentos de revisiones, contenido de revisión, contexto de origen, sellos de tiempo y estados de recogida.
WebScrapingAPI la documentación actualmente enumera las APIs de mercado estructuradas para Amazon, eBay, y Walmart, plus las APIs de minoristas para Best Buy, Home Depot, Lowe's, Nordstrom, Target, y Wayfair. Los tipos de páginas, entradas, campos y patrones de respuesta soportados difieren según el punto final, por lo que la documentación pertinente y una solicitud representativa definen el alcance utilizable.
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.
Un alcance programado o administrado puede incluir reglas de coincidencia basadas en identificadores exactos primero, seguidas de marcas, modelos, títulos, atributos, unidades, paquetes y variantes acordadas. Las observaciones ambigüas e inigualables siguen siendo explícitas.
Las APIs documentadas devuelven una observación cuando se procesa una solicitud o un trabajo asincrónico. Las entregas programadas y administradas utilizan una ventana de actualización acordada por fuente, tipo de página, campo y necesidad de negocio. Cada registro debe conservar una marca de tiempo observada en lugar de depender de una afirmación genérica de frescura.
Una entrega contratada recurrente puede conservar observaciones sucesivas y eventos de cambio derivados para campos seleccionados. La historia normalmente comienza cuando comienza la recopilación a menos que se valide una fuente histórica separada, y una página que no está disponible sigue siendo distinta de un producto que se muestra como no está disponible.
El contrato de registro puede distinguir un campo no mostrado por la fuente, una página o objeto no disponible en el contexto solicitado, un fallo de recogida, una excepción de análisis o esquema y una coincidencia que necesita revisión. Estos estados nunca deben ser desglosados en cero, falso o una cadena vacía sin una regla explícita.
Los clientes de proxy mantienen sus coleccionistas, parseres y reglas de calidad a la baja. WebScrapingAPI mantiene puntos finales estructurados documentados dentro de los límites del producto.
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.