# Marketplaces e lojas virtuais

> Marketplaces e lojas virtuais: Anúncios e produtos de eBay, Walmart, Etsy e lojas Shopify.

URL: https://apicultura.app/ferramentas/marketplaces/
Atualizado em 05/11/2026 (2026-11-05).

## O que é Marketplaces e lojas virtuais na APIcultura

Acesse Marketplaces e lojas virtuais pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Anúncios e produtos de eBay, Walmart, Etsy e lojas Shopify. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Comércio e preços](/catalogo/?cat=comercio). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `ebay-anuncio` | Anúncio do eBay | R$ 0,02 | `POST /v1/call/ebay-anuncio` |
| `walmart-produto` | Produto do Walmart | R$ 0,02 | `POST /v1/call/walmart-produto` |
| `walmart-vendedor` | Vendedor do Walmart | R$ 0,01 | `POST /v1/call/walmart-vendedor` |
| `etsy-buscar` | Buscar no Etsy | R$ 0,01 | `POST /v1/call/etsy-buscar` |
| `shopify-produtos-loja` | Produtos de uma loja Shopify | R$ 0,01 | `POST /v1/call/shopify-produtos-loja` |
| `google-shopping-comparar` | Comparar preços no Google Shopping | R$ 0,58 | `POST /v1/call/google-shopping-comparar` |

### Anúncio do eBay (`ebay-anuncio`)

Detalhes de um anúncio do eBay. Preço: R$ 0,02 por chamada.

- `item` (string, obrigatório), ex.: `204690060416`

### Schema de entrada de ebay-anuncio

```json
{
  "required": [
    "item"
  ],
  "properties": {
    "item": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Produto do Walmart (`walmart-produto`)

Detalhes de um produto do Walmart. Preço: R$ 0,02 por chamada.

- `product` (string, obrigatório), ex.: `12164618`

### Schema de entrada de walmart-produto

```json
{
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Vendedor do Walmart (`walmart-vendedor`)

Perfil de um vendedor do Walmart Marketplace. Preço: R$ 0,01 por chamada.

- `seller` (string, obrigatório), ex.: `101011072`

### Schema de entrada de walmart-vendedor

```json
{
  "required": [
    "seller"
  ],
  "properties": {
    "seller": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Buscar no Etsy (`etsy-buscar`)

Resultados de busca do Etsy. Preço: R$ 0,01 por chamada.

- `limit` (integer, opcional), ex.: `12`
- `page` (integer, opcional), ex.: `1`
- `query` (string, obrigatório), ex.: `ceramic mug`

### Schema de entrada de etsy-buscar

```json
{
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "page": {
      "type": "number"
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Produtos de uma loja Shopify (`shopify-produtos-loja`)

Lista os produtos de uma loja Shopify. Preço: R$ 0,01 por chamada.

- `limit` (integer, opcional), ex.: `20`
- `page` (integer, opcional), ex.: `1`
- `store` (string, obrigatório), ex.: `allbirds.com`

### Schema de entrada de shopify-produtos-loja

```json
{
  "required": [
    "store"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "page": {
      "type": "number"
    },
    "store": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Comparar preços no Google Shopping (`google-shopping-comparar`)

Ofertas, preços e vendedores do Google Shopping. Preço: R$ 0,58 por chamada.

- `condition` (string, opcional)
- `country` (string, opcional, padrão "us")
- `language` (string, opcional, padrão "en")
- `limit` (integer, opcional, mín. 1, máx. 10), ex.: `10`
- `query` (string, obrigatório), ex.: `airpods`
- `sortBy` (string, opcional)

### Schema de entrada de google-shopping-comparar

```json
{
  "required": [
    "query"
  ],
  "properties": {
    "condition": {
      "type": "string",
      "maxLength": 2000
    },
    "country": {
      "type": "string",
      "maxLength": 2000
    },
    "language": {
      "type": "string",
      "maxLength": 2000
    },
    "limit": {
      "type": "number"
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "sortBy": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

## Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta `call` com o slug do endpoint e a entrada:

```json
{ "name": "call", "arguments": { "slug": "ebay-anuncio", "input": {"item":"204690060416"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/ebay-anuncio \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"item":"204690060416"}'
```

## Formato da resposta, preço e limites

A resposta é JSON com `data` (o resultado do endpoint) e `meta` (inclui `cost_brl`, o valor cobrado). Preço deste endpoint: R$ 0,02 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use `max_cost_brl` para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

## Workflows que usam Marketplaces e lojas virtuais

- [Monitor de preços de produtos nos marketplaces](/workflows/precos-concorrentes/)

## Experimente

Teste no playground interativo: [Marketplaces e lojas virtuais no playground](/ferramentas/ferramenta.html?slug=marketplaces). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Marketplaces e lojas virtuais é marca de seus respectivos donos, citada apenas para identificar a integração.