Search
/api/olx-br/search
Search ads across all categories by query with page pagination
Scrappa's OLX Brazil API returns public olx.com.br classifieds as structured JSON. Search ads by query and category with page pagination, and open any ad by its listing id for a numeric BRL price, ISO 8601 date, attributes and full-size images. Contact data is never returned. Scrappa is an independent service and is not affiliated with or endorsed by OLX.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/olx-br/search?query=carro&page=1" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"success": true,
"data": {
"total": 58931,
"page": 1,
"results": [
{
"id": "1400000000",
"title": "Carro em bom estado",
"created_at": "2026-11-19T15:38:50Z",
"price": { "value": 947950.0, "currency": "BRL" },
"seller_type": "private"
}
]
},
"meta": { "endpoint_family": "search", "billable": true }
}
Structured data for real applications. Here are some ideas.
Track asking prices in BRL for cars and other categories across Brazilian cities.
Search the cars hub by query and price, then open any ad for its specifications.
Page through search results and read ISO 8601 dates from the real ad date.
Compare listing counts and price ranges per category and location.
OLX Brazil scraper API
The OLX Brazil API is built for price research, vehicle sourcing and local deal monitoring. Each ad carries id, title, url, a numeric BRL price, location, an ISO 8601 date, full-size image urls, seller type and attributes.
Search by query and category slug. Location, price and sort are not supported and return 422.
Page from 1 to 100 and read the real total from the upstream state.
Open any ad by its listing id for attributes and full-size images.
Prices are parsed from the locale string into numbers with BRL currency.
Seller names, phone numbers and contact details are never returned.
Search by query with page pagination across all categories. Each row reports its own category.
Open OLX Brazil Search API docsOpen an ad by its listing id to get the authoritative numeric price, date and images.
Open OLX Brazil Listing API docsEverything you need in one API.
/api/olx-br/search
Search ads across all categories by query with page pagination
/api/olx-br/listing
One ad with numeric price, attributes and full-size images
See how Scrappa compares to ScrapingBee / ScraperAPI.
| Feature | Scrappa | ScrapingBee / ScraperAPI |
|---|---|---|
| OLX Brazil ads as JSON | Build your own parser | |
| Numeric BRL price parsing | Parse it yourself | |
| Price per 1k requests | From $0.20 | Varies by credits per request |
| Unified API key | Yes (500+ APIs) | Scraping only |
No. Scrappa is an independent service and is not affiliated with or endorsed by OLX. The OLX Brazil API returns structured JSON from public olx.com.br ads through a Scrappa API key.
Each successful request costs one credit after the 500 free monthly credits. Failed requests and unknown ads are never billed.
Use the exact listId value returned by the search endpoint. It is accepted unchanged by the listing endpoint.