OLX Brazil Scraper

OLX Brazil Scraper: listings from olx.com.br by search term, state, category or a URL you paste

Type a Portuguese search term, pick a state, or paste an OLX results page, and every ad on those pages comes back as a row: id, title, price in reais, category, city and state, publish date, photos, whether the seller is private or a business, and the link.

The awkward part first. There are no seller phone numbers. OLX keeps them off the results pages this reads, and the run does not go hunting for them elsewhere. The seller's public display name and whether they are private or a business is what you get.

🏷️ What OLX Brazil Scraper does

Fill in the form, paste links, or do both in one run. The form is a search term plus any mix of state, region, category, price band and sort order. A pasted URL keeps every filter already on it, so a search you set up in OLX's own interface carries over exactly as you left it.

Results pages only. A search page, a category page, a state page. A single ad URL is not one of those and comes back as an uncharged diagnostic row saying so.

region narrows inside a state, using the slug OLX prints in its own URLs, like sao-paulo-e-regiao. Two things about it. It needs a state to work against, and OLX ignores a slug it does not recognise without saying so, handing back the whole state with no error. The run checks the rows it got against the region you asked for, and if they do not match it adds one uncharged row naming slugs that would have worked.

Listings are deduplicated on listingId across the whole run, so the same ad found under two searches is delivered and billed once.

📥 What you give it

{
  "searchQueries": ["notebook"],
  "state": "SP",
  "category": "informatica",
  "sortBy": "date",
  "minPrice": 500,
  "maxPrice": 3000,
  "maxItems": 250
}

maxItems is a total, not a figure per search, so the first term in a long list can use the whole allowance before the others get a turn. If you paste URLs and also pick a category in the form, the category is not applied to the pasted links: their own paths win.

📤 What you get back

A real row from a run on 20 September 2026:

{
  "listingId": "1536762825",
  "title": "iPhone 13",
  "price": 2000,
  "priceLabel": "R$ 2.000",
  "currency": "BRL",
  "oldPrice": null,
  "oldPriceLabel": null,
  "category": "Celulares e Smartphones",
  "categoryId": "3060",
  "parentCategoryId": "3000",
  "city": "Guaporé",
  "state": "RS",
  "stateName": "Rio Grande do Sul",
  "neighbourhood": null,
  "areaCode": "54",
  "locationLabel": "Guaporé - RS",
  "publishedAt": "2026-09-19T22:45:31.000Z",
  "publishedTimestamp": 1789857931,
  "sellerType": "private",
  "sellerName": "Lucassantos509",
  "thumbnailUrl": "https://img.olx.com.br/images/17/173642924789016.jpg",
  "imageUrls": ["https://img.olx.com.br/images/17/173642924789016.jpg", "..."],
  "imageCount": 3,
  "hasVideo": false,
  "isFeatured": true,
  "isBumped": true,
  "hasFreeShipping": true,
  "attributes": {
    "Categoria": "Celulares e Smartphones",
    "Marca": "APPLE",
    "Modelo": "IPHONE 13",
    "Condição": "Usado - Excelente",
    "Memória interna": "128GB",
    "Cor": "Branco",
    "Saúde da bateria": "Boa (80% até 94%)",
    "Aceita trocas": "Não"
  },
  "url": "https://rs.olx.com.br/regioes-de-caxias-do-sul-e-passo-fundo/celulares/iphone-13-1536762825",
  "searchQuery": "iphone",
  "searchUrl": "https://www.olx.com.br/brasil?q=iphone",
  "page": 1,
  "position": 1,
  "scrapedAt": "2026-09-20T07:05:04.533Z"
}

The imageUrls list is cut short above. A real row carries all of them.

🧾 Reading the output

Listing rows carry no charged field at all. The flag exists only on the sample and diagnostic rows, to mark them as not real results. Filter on _sample and _diagnostic being absent.

One search failing never stops the others.

▶️ How to run it

1. Open OLX Brazil Scraper and click Try for free. 2. Type a term into Search terms, or paste links into OLX search URLs. 3. Pick a State (UF) and a Category if you want to narrow it, and set a price band. 4. Set Maximum listings. Start around 20 to see what the rows look like. 5. Click Start, then download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost?

$0.85 per 1,000 listings. Flat on every Apify plan, with no volume tiers.

One billed row per listing delivered. The sample row is not billed, diagnostic rows are not billed, the region warning is not billed, and an ad found under two of your searches is billed once.

💡 What people use it for

• Price tracking for one model in one state, on a schedule, diffing on listingId.
• Property and rental research, where attributes carries Quartos, Banheiros and IPTU.
• Building a list of dealers and shops in a category, keeping rows where sellerType is business.
• Watching what is new: sort by date, keep maxItems small, and read publishedAt.
• Comparing the same search across several states in one run, since every row says which search and

which URL produced it.

🚧 What it does not do

• No seller phone numbers. They are not on the pages this reads, and it does not go looking for

them anywhere else.

• No single ad pages. Paste a search or category URL, not an ad URL. An ad URL comes back as an

uncharged NOT_A_SEARCH_URL row.

• No jobs. vagas-de-emprego is a separate OLX product that renders differently and carries no

listing data on the results page.

• No "highest price first" sort. OLX offers it in its own interface but not as something a

plain request can ask for. Relevance, newest and lowest price all work.

• About 5,000 listings per search is OLX's ceiling, not ours. After page 100 OLX keeps handing

back page 100. Split by state, category or price band to reach deeper stock.

• A search can come back short. If OLX stops serving pages partway through, the rows already

collected are kept and the run moves on, and there is no row in the dataset marking where it stopped. Compare the count you asked for against the count you got.

• Attribute keys are OLX's, not ours. They are in Portuguese and they change per category, so

do not hard-code them.

🧭 Which marketplace scraper do you need?

❓ Questions people ask

Do I need a Brazilian address to run this? No. Nothing about the input asks for one and there is nothing for you to set up.

Can I search in English? The term goes to OLX exactly as you typed it, and OLX's index is Portuguese, so English terms return very little. State names do accept English spellings.

How do I get more than 5,000 listings for one term? Split it up. Several states, several price bands, or narrower categories, all in the same run.

Why did my region get ignored? OLX did not recognise the slug. Look for the uncharged REGION_NOT_APPLIED row: it lists slugs that do work for that state.

Can I schedule it? Yes. listingId is stable, so diffing one run against the next shows what appeared and what sold. Set sortBy to date for that.

Is this legal? These are public ads. They carry personal data, which GDPR and similar laws cover, so have a reason for collecting it. Apify's write-up on scraping and the law is a good starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the search term or the URL you used and the run ID. The errorCode on the diagnostic row usually names the problem on its own.