# Americanas Search API Documentation

<p><strong>Americanas Search API Documentation</strong> Search public Americanas products by query. Filter by category id, brand, price range and sort order. Every item carries the sale price and list price as numbers in reais, the discount, brand, brand id, availability and full size photos. Use a category id from the categories endpoint unchanged, for example /2623/2647. A top level id such as /2623 also works. A page requests up to 50 items and can be shorter after filters. Up to 2,500 results are reachable per query. Items outside a requested price range are never returned. Cards are lean; full variants, specs and installments stay on the product endpoint. The product id works unchanged in the product and reviews endpoints. The exact charge is in meta.credits: 1 credit on the primary exit, or 0 credits for an empty answer. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/americanas-api/americanas_search](https://scrappa.co/docs/americanas-api/americanas_search)
- **API group:** Americanas API
- **Endpoint:** `GET https://scrappa.co/api/americanas/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | Search words, for example geladeira |
| `category` | string | No | Category id from the categories endpoint, for example /2623/2647 |
| `sort` | string | No | relevance, price_asc, price_desc, top_sale or discount |
| `min_price` | number | No | Minimum price in reais |
| `max_price` | number | No | Maximum price in reais |
| `brand` | string | No | Numeric brand id from search, for example 918 |
| `page` | integer | No | Page number, default 1, up to 50 |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | Invalid query, filter, sort or page. |
|  | Error | Upstream unavailable, not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
