OLX Brazil Scraper

Extract listings from OLX Brazil (olx.com.br), the largest classifieds site in the country with tens of millions of active ads. Give it search URLs, plain-text queries, or both. You get back structured data for every listing: title, price in BRL, photos, location down to neighbourhood level, category attributes and seller type. Turn on the detail option and you also get the full description, the seller's name and the CEP postal code.

$100 per 500 listings. Premium flat rate with detail enrichment included and no compute or platform charges on top.

Why this scraper

✅ Any olx.com.br URL works. Search pages, category pages, state paths like /imoveis/venda/estado-sp. Copy the URL from your browser with the filters you already applied and paste it.

✅ Keyword search built in. No URL needed. Type iPhone 13 or apartamento and pick one of the 27 states, or search all of Brazil at once.

✅ Filters run inside OLX's own query. Price range, seller type and sorting are sent to OLX, not applied after the fact. Filtered-out ads never reach your dataset and never cost you anything.

✅ Real sorting at the source. Most relevant, newest first, cheapest first or most expensive first. Verified against the live site, including the price-descending order most scrapers get wrong.

✅ Clean, typed output. Prices come as integers plus the display string. Timestamps come as ISO 8601 plus epoch seconds. Data is read from OLX's own page payload, so fields match exactly what the site shows.

✅ No duplicates. Mix as many URLs and queries as you want in one run. Rows are de-duplicated by listing ID.

✅ Honest limits. OLX serves at most ~5,000 listings per search. When you hit that ceiling, the log tells you to split by state or category. When a search returns nothing, the log repeats the exact keyword, state and price range you used so you know what to loosen.

What you can build with it

Real estate analysis. Track apartment and house inventory by state, city and neighbourhood. Compare asking prices across regions. Sort by newest to catch fresh listings the day they appear.

Lead generation. Filter to business sellers only and you have a prospect list of dealerships, real-estate agencies and resellers, with names and regions. Feed it straight into your CRM.

Resale and arbitrage. Watch prices for iPhones, consoles, notebooks or car parts. Set a tight maxPrice and sort cheapest-first to surface underpriced listings before anyone else.

Market monitoring. Run it on a schedule, push new rows to Google Sheets or Slack, and you have an alerting system for new listings that match your criteria.

Data products. Keep a classifieds aggregator, price index or dashboard updated with fresh OLX data, photos included.

How to use it

1. Paste an OLX URL into Search or Category URLs, or type keywords into Search Queries (or both).
2. Set Max Results to 30-100 for a first test.
3. Pick a sort order and, for keyword searches, a state.
4. Optionally set a price range or restrict to business sellers.
5. Run it. Export from the dataset as JSON, CSV or Excel when it finishes.

Example: scrape a category URL

{
    "searchUrls": ["https://www.olx.com.br/imoveis/venda/estado-sp"],
    "maxResults": 100
}

Example: keyword search in one state, newest first

{
    "searchQueries": ["iPhone 13"],
    "state": "RJ",
    "sortBy": "newest",
    "maxResults": 200
}

Example: apartments in MG between R$100k and R$500k, business sellers, cheapest first

{
    "searchUrls": ["https://www.olx.com.br/imoveis/venda/estado-mg"],
    "minPrice": 100000,
    "maxPrice": 500000,
    "sortBy": "price_asc",
    "includeBusinessOnly": true,
    "maxResults": 500
}

Example: cars from two states plus keyword queries, with full seller data

{
    "searchUrls": [
        "https://www.olx.com.br/autos-e-pecas/carros-vans-e-utilitarios/estado-sp",
        "https://www.olx.com.br/autos-e-pecas/carros-vans-e-utilitarios/estado-rj"
    ],
    "searchQueries": ["Honda Civic", "Toyota Corolla"],
    "state": "SP",
    "minPrice": 30000,
    "maxPrice": 80000,
    "sortBy": "price_asc",
    "enrichDetails": true,
    "maxResults": 1000
}

Input settings

Parameter	Type	Default	Description
searchUrls	string[]		One or more OLX Brazil URLs. Search pages, category pages and state paths all work.
searchQueries	string[]	[]	Plain-text search terms, e.g. iPhone 13, Gol G5, Apartamento.
maxResults	integer	100	Cap across all URLs and queries. 0 means unlimited (internal cap of 50,000).
sortBy	select	Most Relevant	Newest First, Price: Low to High or Price: High to Low. If a URL already carries a sort parameter, the URL wins for that source.
state	select	(any)	Limits plain-text queries to one state by UF code (SP, RJ, MG...). Invalid codes fail with a clear error. URLs keep their own state.
minPrice	integer	(none)	Lowest price in R$, applied inside the OLX query.
maxPrice	integer	(none)	Highest price in R$, applied inside the OLX query.
includeBusinessOnly	boolean	false	Keep only ads from professional sellers (lojas e profissionais).
enrichDetails	boolean	false	Also open each listing page to get description, seller name and CEP. Billed at the enriched rate, takes longer.

Output

One row per listing. Real example with enrichDetails on:

{
    "listingId": "1529647315",
    "title": "Notebook Gamer HP Victus 15 - Ryzen 5 + RTX 2050 | 16GB DDR5 + 1TB SSD",
    "description": "Notebook gamer em perfeito estado de conservação, com pouquíssimas marcas de uso...",
    "url": "https://pr.olx.com.br/regiao-de-curitiba-e-paranagua/informatica/notebooks/notebook-gamer-hp-victus-15-1529647315",
    "price": 3800,
    "priceDisplay": "R$ 3.800",
    "currency": "BRL",
    "city": "Curitiba",
    "state": "PR",
    "neighborhood": "Boqueirão",
    "locationDisplay": "Curitiba, Boqueirão - DDD 41",
    "zipcode": "81750370",
    "categoryId": "19020",
    "categoryName": "Notebooks",
    "parentCategoryName": "Informática",
    "photos": [
        "https://img.olx.com.br/images/62/623693558761903.jpg",
        "https://img.olx.com.br/images/71/715605558796206.jpg"
    ],
    "thumbnailUrl": "https://img.olx.com.br/images/62/623693558761903.jpg",
    "imageCount": 6,
    "videoCount": 0,
    "properties": [
        { "name": "Marca", "value": "HP" },
        { "name": "Condição", "value": "Usado - Excelente" },
        { "name": "Memória RAM", "value": "16 GB" }
    ],
    "seller": {
        "name": "Júlio César",
        "type": "private",
        "id": "41206719",
        "phoneAvailable": true
    },
    "isBusiness": false,
    "isFeatured": false,
    "postedAt": "2026-08-26T15:57:23+00:00",
    "postedAtTimestamp": 1787759843,
    "lastBumpAgeSecs": 0,
    "ddd": "41",
    "searchUrl": null,
    "searchQuery": "notebook gamer",
    "scrapedAt": "2026-08-27T14:10:00+00:00"
}

All fields

Field	Type	Description
listingId	string	Unique OLX listing ID
title	string	Listing headline
description	string	Full description text (needs enrichDetails)
url	string	Listing URL on the regional subdomain
price	number	Integer price in R$. null when the ad says "À combinar"
priceDisplay	string	Price as shown on the site
currency	string	Always BRL
city	string	City name
state	string	Two-letter UF code
neighborhood	string	Neighbourhood name
locationDisplay	string	OLX's combined location string
zipcode	string	CEP postal code (needs enrichDetails)
ddd	string	Phone area code of the region
categoryId	string	OLX category ID
categoryName	string	Category label, e.g. Notebooks
parentCategoryName	string	Top-level category, e.g. Informática (needs enrichDetails)
properties	object[]	Category attributes: bedrooms, area, mileage, year, RAM and so on
photos	string[]	All image URLs in original resolution
thumbnailUrl	string	First photo
imageCount	number	Number of photos
videoCount	number	Number of videos
seller.name	string	Seller name (needs enrichDetails)
seller.type	string	business or private
seller.id	string	OLX seller ID (needs enrichDetails)
seller.phoneAvailable	boolean	Whether the ad has a phone contact (needs enrichDetails)
isBusiness	boolean	Same as seller.type == "business"
isFeatured	boolean	Promoted ad slot
postedAt	string	When the ad was listed, ISO 8601
postedAtTimestamp	number	Same, in epoch seconds
lastBumpAgeSecs	number	Seconds since the seller last bumped the ad
searchUrl	string	Which input URL produced the row
searchQuery	string	Which input query produced the row
scrapedAt	string	Collection time, ISO 8601

Pricing

$100 per 500 listings ($0.20 per result), pay per result. You only pay for rows that land in your dataset. Platform usage is included, so there is nothing to add for compute, storage writes or run time.

Run	What you pay
100 listings	$20.00
500 listings	$100.00
1,000 listings	$200.00
5,000 listings	$1,000.00

Detail enrichment (full description, seller name and CEP from each listing's own page) is included at the same rate. Turn on enrichDetails and the price per result does not change.

Tips for better results

• Start with maxResults between 30 and 100 to check the data, then scale up.
• Broad keywords beat long phrases. OLX matches loosely and tight phrases drop real ads.
• Prefer minPrice/maxPrice over filtering in your own pipeline. They run inside the OLX query, so filtered ads cost you nothing.
• The cheap end of OLX has R$1 placeholder ads. For a clean cheapest-first sweep, combine sortBy: "price_asc" with a sensible minPrice.
• Keep enrichDetails off unless you need descriptions, seller names or CEPs. Everything else comes at the standard rate.
• Need more than 5,000 listings from one category? Split into several URLs by state or sub-category and run them together. Duplicates are removed automatically.

Run it from your own code

Like every Apify Actor, you can start runs over the API and pull results as JSON:

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("pedrocadev/olx-brazil-scraper").call(run_input={
    "searchQueries": ["iphone 13"],
    "state": "SP",
    "sortBy": "newest",
    "maxResults": 100,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"], item["priceDisplay"], item["city"])

The same works in JavaScript with apify-client, or with plain HTTP calls. You can also schedule runs in the Apify Console and connect webhooks, Zapier, Make, n8n, Google Sheets or Slack to each finished run.

FAQ

How fresh is the data? Every run fetches the live site. Nothing is cached or replayed.

Can I get listings from a specific city? Yes. Open olx.com.br, filter to your city, copy the URL and paste it into searchUrls. City and neighbourhood also come back on every row, so you can filter after the run too.

What happens with ads without a price? Ads marked "À combinar" come back with price: null and the original text in priceDisplay. If you set a price filter, they are excluded.

Does it collect phone numbers? No. OLX hides phone numbers behind authentication. The seller.phoneAvailable flag tells you whether the ad has a phone contact at all.

Why did my run return fewer listings than maxResults? The search simply has fewer matching ads, or OLX's ~5,000 per-search ceiling was reached. The run log states which one happened.

Is scraping OLX legal? This Actor only reads publicly accessible listing pages, the same content any visitor sees. You are responsible for using the data in line with applicable law, OLX's terms and the LGPD, especially for any personal data such as seller names. Do not use the data for spam or fraud.

Support

Found a bug or need a field that is not in the output? Open an issue on the Actor's Issues tab and it will be looked at quickly. Feature requests are welcome.