Americanas Search API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
6 optional filters available.
string
Required
Search words, for example geladeira
coffee shops
string
Optional
Category id from the categories endpoint, for example /2623/2647
example
string
Optional
relevance, price_asc, price_desc, top_sale or discount
relevance
number
Optional
Minimum price in reais
10
number
Optional
Maximum price in reais
10
string
Optional
Numeric brand id from search, for example 918
example
integer
Optional
Page number, default 1, up to 50
1
Errors
Handle these documented responses before retrying or showing customer-facing failures.
API Error
Invalid query, filter, sort or page.
API Error
Upstream unavailable, not billed.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.