> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Flipkart API

> Busque produtos na loja Flipkart e leia as páginas de produto dela em JSON: posições com preços, notas, número de avaliações e marcas na busca, e preço, estoque e imagens em cada página de produto.

Busque produtos na loja Flipkart (flipkart.com) e leia as páginas de produto dela pela API de tarefas assíncronas. Envie `COMMERCE_SERP` com `site` `flipkart` para receber os produtos que uma busca mostra, na ordem da loja, ou `COMMERCE_PRODUCT` com a `url` de um produto para ler esse produto. Cada busca ou página de produto concluída custa **0.5 crédito**.

## Busca

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_SERP", "payload": { "site": "flipkart", "query": "wireless earbuds", "limit": 3 } }'
```

Envie a tarefa e depois consulte `GET /v1/async/task/{id}` ou receba o webhook. Veja [Tarefas assíncronas](https://docs.querying.ai/pt/concepts/async-tasks.md).

### Parâmetros

* `site`: Obrigatório. `flipkart`.
* `query`: Obrigatório. Termo de busca, de 1 a 500 caracteres.
* `limit`: Inteiro opcional de 1 a 40, com padrão 20.
* `country`: Opcional. O padrão é `IN`, o país da loja. Qualquer outro país é recusado com `422 REGION_UNSUPPORTED`.

Só os campos de payload listados acima são aceitos. Omita `include`: até `include: {}` retorna `422 VALIDATION_ERROR` em `payload.include` antes da reserva de créditos.

### Exemplo de resposta

```json theme={"theme":"css-variables"}
{
  "site": "flipkart",
  "query": "wireless earbuds",
  "country": "IN",
  "returnedCount": 3,
  "products": [
    {
      "rank": 1,
      "productId": "ACCHQGW2GYZXP57R",
      "title": "GWALBROS New Trending BUDS R2 True Wireless Earbuds with Mic, 12.4mm Drivers F03 Bluetooth",
      "url": "https://www.flipkart.com/gwalbros-new-trending-buds-r2-true-wireless-earbuds-mic-12-4mm-drivers-f03-bluetooth/p/itm07d92543aca98?pid=ACCHQGW2GYZXP57R",
      "price": 361,
      "currency": "INR",
      "rating": 3.7,
      "reviewCount": 504,
      "brand": "GWALBROS",
      "imageUrl": "https://rukmini1.flixcart.com/image/416/416/xif0q/headphone/e/2/r/bx-2r-techio-original-imahpyystsr3y4dt.jpeg?q=70"
    },
    {
      "rank": 2,
      "productId": "ACCH77MF4NYVHZTE",
      "title": "Aroma NB121 Pods Upto 40 Hours Playtime* Type C Fast Charging Dual Pairing Earbuds Bluetooth",
      "url": "https://www.flipkart.com/aroma-nb121-pods-upto-40-hours-playtime-type-c-fast-charging-dual-pairing-earbuds-bluetooth/p/itm911b47c91c5dd?pid=ACCH77MF4NYVHZTE",
      "price": 300,
      "currency": "INR",
      "rating": 3.5,
      "reviewCount": 143763,
      "brand": "Aroma",
      "imageUrl": "https://rukmini1.flixcart.com/image/416/416/xif0q/headphone/d/u/0/nb121-pods-upto-40-hours-playtime-type-c-fast-charging-dual-original-imahh4a72k7jbk2h.jpeg?q=70"
    },
    {
      "rank": 3,
      "productId": "ACCHH9JJMVTHTGBN",
      "title": "DSSB Black Edition TWS Bluetooth Earbuds with Mic, Noise Cancellation Bluetooth",
      "url": "https://www.flipkart.com/dssb-black-tws-bluetooth-earbuds-mic-noise-cancellation/p/itmd48a4d77fe026?pid=ACCHH9JJMVTHTGBN",
      "price": 283,
      "currency": "INR",
      "rating": 3.6,
      "reviewCount": 28696,
      "brand": "DSSB",
      "imageUrl": "https://rukmini1.flixcart.com/image/416/416/xif0q/headphone/b/m/k/black-edition-tws-bluetooth-earbuds-with-mic-noise-cancellation-original-imahmrgh5eh2dhns.jpeg?q=70"
    }
  ]
}
```

### Campos do resultado

* `site`, `query` e `country` repetem a requisição. `returnedCount` é o número de itens em `products`.
* Cada produto inclui `rank`, `productId`, `title` e `url`. `productId` é o ID de produto da própria loja. `rank` segue a ordem padrão da loja, e os anúncios que a loja marca como patrocinados ficam de fora.
* `price`, `rating`, `reviewCount`, `imageUrl` e `brand` aparecem quando a página de resultados os mostra. `price` é um número na `currency` do produto (ISO 4217); quando os tamanhos têm preços diferentes, é o menor.
* `rating` usa uma escala de cinco pontos. Números de avaliações abreviados, como 999+, ficam de fora.
* Cada busca retorna produtos da primeira página de resultados da loja, que tem 40 posições, com anúncios patrocinados incluídos.

## Página de produto

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_PRODUCT", "payload": { "url": "https://www.flipkart.com/gwalbros-new-trending-buds-r2-true-wireless-earbuds-mic-12-4mm-drivers-f03-bluetooth/p/itm07d92543aca98?pid=ACCHQGW2GYZXP57R" } }'
```

### Parâmetros

* `url`: Obrigatório. Uma página de produto da loja Flipkart, com até 2.048 caracteres: `flipkart.com/{name}/p/{itm}?pid={pid}`. As `url` de produto que uma busca retorna funcionam como estão. Os parâmetros que não afetam o resultado, como códigos de rastreamento, são removidos antes da leitura.
* `country`: Opcional. O padrão é `IN`, o país da página. Qualquer outro país é recusado com `422 REGION_UNSUPPORTED`.

Só os campos de payload listados acima são aceitos. Omita `include`: até `include: {}` retorna `422 VALIDATION_ERROR` em `payload.include` antes da reserva de créditos.

### Exemplo de resposta

```json theme={"theme":"css-variables"}
{
  "site": "flipkart",
  "country": "IN",
  "url": "https://www.flipkart.com/gwalbros-new-trending-buds-r2-true-wireless-earbuds-mic-12-4mm-drivers-f03-bluetooth/p/itm07d92543aca98?pid=ACCHQGW2GYZXP57R",
  "productId": "ACCHQGW2GYZXP57R",
  "title": "GWALBROS New Trending BUDS R2 True Wireless Earbuds with Mic, 12.4mm Drivers F03 Bluetooth",
  "brand": "GWALBROS",
  "price": 361,
  "currency": "INR",
  "inStock": true,
  "rating": 3.7,
  "reviewCount": 504,
  "images": [
    "https://rukmini1.flixcart.com/image/1500/1500/xif0q/headphone/e/2/r/bx-2r-techio-original-imahpyystsr3y4dt.jpeg?q=70",
    "https://rukmini1.flixcart.com/image/1500/1500/xif0q/headphone/x/f/b/nord-buds-2r-tws-bluetooth-earbuds-with-deep-bass-enc-mic-touch-original-imahpyhynh6e3f9w.jpeg?q=70"
  ],
  "description": "Buy GWALBROS New Trending BUDS R2 True Wireless Earbuds with Mic, 12.4mm Drivers F03 Bluetooth for Rs.1499.0 Online, Also get GWALBROS New Trending BUDS R2 True Wireless Earbuds with Mic, 12.4mm…"
}
```

### Campos do resultado

* `site`, `country`, `url` e `productId` identificam a página. `url` é a página lida, e `productId` é o mesmo que uma busca retorna.
* `title` sempre aparece. `brand`, `price`, `currency`, `inStock`, `rating`, `reviewCount`, `images` e `description` aparecem quando a página os mostra.
* `price` é o que um comprador paga conforme a página mostra ao abrir, antes de cupons e frete, em `currency` (ISO 4217). `inStock` é a disponibilidade do produto.
* `rating` usa uma escala de cinco pontos com duas casas decimais. `reviewCount` é o número de avaliações.
* `images` lista até 30 fotos da galeria do produto, na ordem da página.
* `description` é texto simples com uma linha por parágrafo, com até 10.000 caracteres; o texto que só aparece dentro de imagens não é incluído. `description` é o resumo curto que a loja publica para os buscadores.

## Erros e cobrança

* Uma busca que não retorna produtos termina como tarefa com falha.
* Uma página de produto que a loja responde com 404 ou 410, como um produto removido, encerra a tarefa com `PAGE_UNAVAILABLE`, e a mensagem traz a resposta da loja. Se a loja recusar a leitura com 403, 412, 429 ou 435, a tarefa espera e tenta de novo por até 6 minutos. As demais leituras com falha, e uma recusa que dure mais, terminam com `ENGINE_NO_RESULT`.
* Só as tarefas concluídas são cobradas: 0.5 crédito por busca ou página de produto.

## Relacionado

* [Myntra](https://docs.querying.ai/pt/engines/myntra.md)
* [Nykaa](https://docs.querying.ai/pt/engines/nykaa.md)
* [Todas as lojas do Commerce](https://docs.querying.ai/pt/engines/overview.md#commerce)
* [Créditos e limites](https://docs.querying.ai/pt/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.