OLX Brazil API

OLX Brazil Scraper API for Classified Search and Ad Details

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.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
2
Endpoints
Brazil
Coverage
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

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.

Request preview
Request
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"
JSON response
{
  "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 }
}

What you can build

Structured data for real applications. Here are some ideas.

Price Monitoring

Track asking prices in BRL for cars and other categories across Brazilian cities.

Vehicle Sourcing

Search the cars hub by query and price, then open any ad for its specifications.

Fresh Ad Alerts

Page through search results and read ISO 8601 dates from the real ad date.

Market Research

Compare listing counts and price ranges per category and location.

OLX Brazil scraper API

OLX Brazil API for classified ads and prices

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.

Choose the right OLX Brazil API endpoint

Use Search for market coverage

Search by query with page pagination across all categories. Each row reports its own category.

Open OLX Brazil Search API docs

Use Listing for full records

Open an ad by its listing id to get the authoritative numeric price, date and images.

Open OLX Brazil Listing API docs

Available endpoints

Everything you need in one API.

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to ScrapingBee / ScraperAPI.

OLX Brazil ads as JSON
Scrappa
ScrapingBee / ScraperAPI
Build your own parser
Numeric BRL price parsing
Scrappa
ScrapingBee / ScraperAPI
Parse it yourself
Price per 1k requests
Scrappa
From $0.20
ScrapingBee / ScraperAPI
Varies by credits per request
Unified API key
Scrappa
Yes (500+ APIs)
ScrapingBee / ScraperAPI
Scraping only

Key features

Ad search by query and category with page pagination
Numeric BRL prices parsed from the pt-BR display string
ISO 8601 dates from Unix seconds, never a relative age
Full ad details with attributes and full-size images
1 to 100 page pagination with the real upstream total

Frequently asked questions

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.

Start using the OLX Brazil API

Sign up and get 500 free credits. No credit card required.