Skip to content
Scrappa Get API key
Americanas API 1 credit / request

Americanas Search API Documentation

GET https://scrappa.co/api/americanas/search

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.

Americanas Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/americanas/search
Auth header
x-api-key
Cost
1 credit / request
q = coffee shops
Response preview
200 OK
Example JSON appears below when a response schema is available for this 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.

q string Required

Search words, for example geladeira

Example value coffee shops
category string Optional

Category id from the categories endpoint, for example /2623/2647

Example value example
sort string Optional

relevance, price_asc, price_desc, top_sale or discount

Example value relevance
min_price number Optional

Minimum price in reais

Example value 10
max_price number Optional

Maximum price in reais

Example value 10
brand string Optional

Numeric brand id from search, for example 918

Example value example
page integer Optional

Page number, default 1, up to 50

Example value 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.