Entidade estável
Identidade do produto
Marca, modelo, título canônico, categorias, identificadores, descrições, atributos e mídia.
- ASIN / SKU / GTIN / MPN
- Brand & model
- Category & attributes
Produtos, preços e avaliações
Colete produtos, preços, promoções, estoques, vendedores e avaliações para análise de varejo. Escolha APIs de comércio estruturadas, conjuntos de dados ou feeds recorrentes.
Modelo de registro comercial
Separar a identidade das observações que mudam por vendedor, localização, página e tempo. O resultado é mais fácil de comparar, atualizar e governar.
Entidade estável
Marca, modelo, título canônico, categorias, identificadores, descrições, atributos e mídia.
Configuração
Tamanho, cor, capacidade, unidade, embalagem, estilo ou outra configuração definida pela fonte de um produto.
Observação limitada no tempo
Preço, preço de lista, promoção, condição, disponibilidade, envio, recolha e contexto de realização.
Entidade do mercado
A identidade do comerciante público e o contexto da loja são mantidos separados do produto e oferecem-lhe suprimentos.
Feedback do público
Avaliações agregadas, distribuições, contagens e campos de cada avaliação, quando disponíveis no endpoint ou escopo selecionado.
Cobertura da fonte
Analise a fonte, o tipo de página, o mercado e os campos necessários antes de escolher uma API ou coleta personalizada.
A documentação atual lista as APIs de mercado e de varejistas com contratos de solicitação e resposta específicos da fonte.
As fontes de varejo, mercado, marca, comparação e revisão são avaliadas com páginas representativas antes de um compromisso recorrente.
Os dados de conta privada, carrinho, caixa ou de cliente estão fora do âmbito de aplicação da web pública.
Campos e registros de exemplo
Comece a partir dos campos que o sistema precisa, em seguida, mapear os valores de fonte, módulos opcionais, identificadores e estados de qualidade em um 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"
}Identidade e correspondência
Manter a observação original, depois adicionar uma camada de identidade contratação apenas onde a comparação é explicável e testável.
Frescos e história
Especifique quando a coleta deve ser executada, qual marca de tempo um registro carrega e quais alterações precisam se tornar história em vez de valores sobreescritos.
No momento da solicitação
Assincrono
Programação
Longitudinal
Qualidade e falta
A qualidade não é uma porcentagem de precisão, mas um conjunto de verificações acordadas e estados observáveis anexados ao campo, registro, fonte e 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 availableOpções de entrega
Proxies
Ideal para · Equipes com coletores existentes.
Explore Infraestrutura de proxiesQue equipes construem
Use os campos e exemplos abaixo para planejar sua análise, produto ou fluxo de monitoramento.
Pilotante representativo
Um piloto útil prova as combinações mais difíceis de fonte e de campo, não apenas as páginas de produto mais limpas.
Breve
Amostra
Contrato
Transmissão
Questões comuns
Colete produtos, preços, promoções, estoques, vendedores e avaliações para análise de varejo. Escolha APIs de comércio estruturadas, conjuntos de dados ou feeds recorrentes.
Explore APIs de comércio para Amazon, Walmart, eBay e outros varejistas compatíveis. Cada página de fonte mostra os tipos de página e campos a verificar em uma amostra.
As classificações, as contagens de revisão, as distribuições de classificações ou os trechos de revisão são documentados para pontos finais selecionados de produtos e também podem ser avaliados em um programa de dados abrangidos. Os campos de revisão variam de acordo com a fonte e o tipo de página, e um resumo de classificação não deve ser apresentado como cobertura completa de revisão a menos que essa cobertura seja verificada.
O modelo de dados mantém a identidade estável do produto separada das variantes da fonte, ofertas limitadas em tempo, contexto do vendedor e observações de revisão. Cada objeto pode manter seu URL de fonte, identificador de fonte, contexto solicitado, tempo de observação e estado de coleta para que as equipes a jusante possam unir registros sem apagar de onde vieram.
A correspondência pode ser incluída em um feed ou programa gerenciado. A amostra confirma identificadores, regras de comparação e como correspondências incertas ou conflitantes aparecem.
As APIs coletam dados quando chamadas. Feeds e Managed Data seguem um cronograma acordado, separando os horários da fonte e da coleta quando disponíveis.
O histórico começa com o monitoramento. A cobertura anterior depende dos registros da fonte ou capturas de arquivo disponíveis. Analise datas e lacunas em uma amostra.
A amostra distingue campos ausentes, páginas indisponíveis, requisições com falha e valores que precisam de revisão. Defina o tratamento de cada estado antes da entrega recorrente.
Sua equipe mantém os coletores com proxies e os parsers próprios com APIs de acesso a páginas. Nós mantemos a extração compatível de Data API e a coleta incluída nos feeds ou em Managed Data.
O escopo é limitado a páginas web públicas elegíveis e campos públicos acordados. Dados de conta privada, carrinho, caixa, encomenda e clientes não são escopo padrão. Os clientes continuam sendo responsáveis por uso legal, retenção, controles de acesso e preços, merchandising, execução ou outras decisões tomadas com os dados entregues.
Produtos, preços e avaliações
Use uma API de comércio documentada no seu próprio fluxo de trabalho, ou mostre-nos as fontes, campos, contexto e janela de atualização que a sua equipe precisa entregar.