API Walmart

A API Walmart permite pesquisar produtos e obter informações detalhadas do produto pelo ID do produto. Ambos os endpoints suportam emulação de dispositivo, localização de entrega e filtros de atendimento.

Endpoints

Endpoint	Descrição
`POST /api/v1/walmart/search`	Pesquisar produtos Walmart com classificação, paginação, filtros de preço e atendimento
`POST /api/v1/walmart/product`	Obter informações detalhadas do produto pelo ID do produto Walmart

Autenticação

Cabeçalho	Valor	Obrigatório
`Authorization`	`Bearer YOUR_API_KEY`	Sim
`Content-Type`	`application/json`	Sim

Pesquisa de Produtos

Bash

POST https://api.scavio.dev/api/v1/walmart/search

Pesquise produtos Walmart e obtenha resultados estruturados incluindo preços, avaliações e disponibilidade.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. Consulta de pesquisa (1-500 caracteres).
`domain`	`string`	`""`	Domínio Walmart.
`device`	`string`	`desktop`	Tipo de dispositivo. Um de: `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	Ordem de classificação. Um de: `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	Número da página inicial (baseado em 1).
`min_price`	`integer`	--	Filtro de preço mínimo (em dólares).
`max_price`	`integer`	--	Filtro de preço máximo (em dólares).
`fulfillment_speed`	`string`	--	Filtro de velocidade de entrega. Um de: `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	Filtro de tipo de atendimento. Atualmente suporta: `in_store`
`delivery_zip`	`string`	--	Código postal de entrega para resultados e disponibilidade localizados.
`store_id`	`string`	--	ID da loja Walmart para disponibilidade na loja.

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/walmart/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "best_seller",
    "min_price": 20,
    "max_price": 100
  }'

Exemplo de Resposta

JSON

{
  "data": {
    "page": 1,
    "products_count": 40,
    "location": {
      "city": "Jacksonville",
      "state": "FL",
      "store_id": "5054",
      "zipcode": "32246"
    },
    "products": [
      {
        "id": "123456789",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/ip/Sony-WH-1000XM5/123456789",
        "image": "https://i5.walmartimages.com/...",
        "price": 248.0,
        "price_strikethrough": null,
        "currency": "USD",
        "rating": 4.7,
        "rating_count": 8230,
        "sponsored": false,
        "out_of_stock": false,
        "seller_name": "Walmart.com",
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "fulfillment": {
          "delivery": true,
          "free_shipping": true,
          "pickup": true,
          "shipping": true
        },
        "pos": 1,
        "variants": []
      }
    ],
    "url": "https://www.walmart.com/search?q=...",
    "html": "",
    "screenshot": ""
  },
  "response_time": 1920,
  "credits_used": 1,
  "credits_remaining": 999
}

Detalhes do Produto

Bash

POST https://api.scavio.dev/api/v1/walmart/product

Obtenha informações detalhadas para um produto Walmart específico pelo seu ID de produto. Retorna preço, descrição, especificações, imagens, avaliações e informações do vendedor.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`product_id`	`string`	--	Obrigatório. ID do produto Walmart (ex. `123456789`).
`domain`	`string`	--	Domínio Walmart.
`device`	`string`	`desktop`	Tipo de dispositivo. Um de: `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	Código postal de entrega para preços localizados.
`store_id`	`string`	--	ID da loja Walmart para disponibilidade na loja.

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/walmart/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"product_id": "123456789"}'

Exemplo de Resposta

JSON

{
  "data": {
    "id": "123456789",
    "sku": "123456789",
    "gtin": "012345678901",
    "price": 248.0,
    "price_strikethrough": 349.99,
    "currency": "USD",
    "rating": 4.7,
    "rating_count": 8230,
    "out_of_stock": false,
    "seller_name": "Walmart.com",
    "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
    "seller_url": null,
    "image": "https://i5.walmartimages.com/...",
    "images": [
      "https://i5.walmartimages.com/..."
    ],
    "fulfillment": {
      "delivery": true,
      "delivery_information": "Arrives today",
      "free_shipping": true,
      "fulfilled_by": "",
      "out_of_stock": false,
      "pickup": true,
      "pickup_information": "Pickup today",
      "shipping": true,
      "shipping_information": "Free shipping"
    },
    "specifications": [
      { "key": "Brand", "value": "Sony" },
      { "key": "Wireless technology", "value": "Bluetooth" }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2310,
  "credits_used": 1,
  "credits_remaining": 998
}

Formato da Resposta

Ambos os endpoints retornam um invólucro de resposta consistente:

Campo	Tipo	Descrição
`data`	`object \| null`	O payload da resposta. `null` se a requisição falhou upstream. A pesquisa retorna `{page, products, location, ...}`; o produto retorna o objeto do produto diretamente.
`response_time`	`number`	Tempo de resposta do servidor em milissegundos
`credits_used`	`number`	Número de créditos consumidos
`credits_remaining`	`number`	Créditos restantes no seu período de faturamento atual

Respostas de Erro

Status	Descrição
`401`	Não autorizado -- chave de API ausente ou inválida
`429`	Limite de taxa ou uso excedido para seu plano
`502`	Erro upstream -- tente novamente após um breve atraso
`503`	Indisponível upstream -- tente novamente mais tarde

Veja Erros para a referência completa de erros e práticas recomendadas de repetição.

Relacionados

Início Rápido -- obtenha sua chave de API e faça sua primeira requisição
API de Pesquisa do Google -- pesquise no Google com dados SERP estruturados
API do YouTube -- pesquise vídeos e extraia metadados
API da Amazon -- pesquise produtos Amazon em 12 marketplaces
Limites de Taxa -- limites por nível de plano

API Walmart

Endpoints

Endpoint	Descrição
`POST /api/v1/walmart/search`	Pesquisar produtos Walmart com classificação, paginação, filtros de preço e atendimento
`POST /api/v1/walmart/product`	Obter informações detalhadas do produto pelo ID do produto Walmart

Autenticação

Cabeçalho	Valor	Obrigatório
`Authorization`	`Bearer YOUR_API_KEY`	Sim
`Content-Type`	`application/json`	Sim

Pesquisa de Produtos

Bash

POST https://api.scavio.dev/api/v1/walmart/search

Pesquise produtos Walmart e obtenha resultados estruturados incluindo preços, avaliações e disponibilidade.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. Consulta de pesquisa (1-500 caracteres).
`domain`	`string`	`""`	Domínio Walmart.
`device`	`string`	`desktop`	Tipo de dispositivo. Um de: `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	Ordem de classificação. Um de: `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	Número da página inicial (baseado em 1).
`min_price`	`integer`	--	Filtro de preço mínimo (em dólares).
`max_price`	`integer`	--	Filtro de preço máximo (em dólares).
`fulfillment_speed`	`string`	--	Filtro de velocidade de entrega. Um de: `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	Filtro de tipo de atendimento. Atualmente suporta: `in_store`
`delivery_zip`	`string`	--	Código postal de entrega para resultados e disponibilidade localizados.
`store_id`	`string`	--	ID da loja Walmart para disponibilidade na loja.

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/walmart/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "best_seller",
    "min_price": 20,
    "max_price": 100
  }'

Exemplo de Resposta

JSON

{
  "data": {
    "page": 1,
    "products_count": 40,
    "location": {
      "city": "Jacksonville",
      "state": "FL",
      "store_id": "5054",
      "zipcode": "32246"
    },
    "products": [
      {
        "id": "123456789",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/ip/Sony-WH-1000XM5/123456789",
        "image": "https://i5.walmartimages.com/...",
        "price": 248.0,
        "price_strikethrough": null,
        "currency": "USD",
        "rating": 4.7,
        "rating_count": 8230,
        "sponsored": false,
        "out_of_stock": false,
        "seller_name": "Walmart.com",
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "fulfillment": {
          "delivery": true,
          "free_shipping": true,
          "pickup": true,
          "shipping": true
        },
        "pos": 1,
        "variants": []
      }
    ],
    "url": "https://www.walmart.com/search?q=...",
    "html": "",
    "screenshot": ""
  },
  "response_time": 1920,
  "credits_used": 1,
  "credits_remaining": 999
}

Detalhes do Produto

Bash

POST https://api.scavio.dev/api/v1/walmart/product

Obtenha informações detalhadas para um produto Walmart específico pelo seu ID de produto. Retorna preço, descrição, especificações, imagens, avaliações e informações do vendedor.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`product_id`	`string`	--	Obrigatório. ID do produto Walmart (ex. `123456789`).
`domain`	`string`	--	Domínio Walmart.
`device`	`string`	`desktop`	Tipo de dispositivo. Um de: `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	Código postal de entrega para preços localizados.
`store_id`	`string`	--	ID da loja Walmart para disponibilidade na loja.

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/walmart/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"product_id": "123456789"}'

Exemplo de Resposta

JSON

{
  "data": {
    "id": "123456789",
    "sku": "123456789",
    "gtin": "012345678901",
    "price": 248.0,
    "price_strikethrough": 349.99,
    "currency": "USD",
    "rating": 4.7,
    "rating_count": 8230,
    "out_of_stock": false,
    "seller_name": "Walmart.com",
    "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
    "seller_url": null,
    "image": "https://i5.walmartimages.com/...",
    "images": [
      "https://i5.walmartimages.com/..."
    ],
    "fulfillment": {
      "delivery": true,
      "delivery_information": "Arrives today",
      "free_shipping": true,
      "fulfilled_by": "",
      "out_of_stock": false,
      "pickup": true,
      "pickup_information": "Pickup today",
      "shipping": true,
      "shipping_information": "Free shipping"
    },
    "specifications": [
      { "key": "Brand", "value": "Sony" },
      { "key": "Wireless technology", "value": "Bluetooth" }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2310,
  "credits_used": 1,
  "credits_remaining": 998
}

Formato da Resposta

Ambos os endpoints retornam um invólucro de resposta consistente:

Campo	Tipo	Descrição
`data`	`object \| null`	O payload da resposta. `null` se a requisição falhou upstream. A pesquisa retorna `{page, products, location, ...}`; o produto retorna o objeto do produto diretamente.
`response_time`	`number`	Tempo de resposta do servidor em milissegundos
`credits_used`	`number`	Número de créditos consumidos
`credits_remaining`	`number`	Créditos restantes no seu período de faturamento atual

Respostas de Erro

Status	Descrição
`401`	Não autorizado -- chave de API ausente ou inválida
`429`	Limite de taxa ou uso excedido para seu plano
`502`	Erro upstream -- tente novamente após um breve atraso
`503`	Indisponível upstream -- tente novamente mais tarde

Veja Erros para a referência completa de erros e práticas recomendadas de repetição.

Relacionados

Início Rápido -- obtenha sua chave de API e faça sua primeira requisição
API de Pesquisa do Google -- pesquise no Google com dados SERP estruturados
API do YouTube -- pesquise vídeos e extraia metadados
API da Amazon -- pesquise produtos Amazon em 12 marketplaces
Limites de Taxa -- limites por nível de plano