OLX Brasil Scraper

🇧🇷 OLX Brasil Cars Scraper

Want OLX Brasil cars in a spreadsheet? This scraper makes it easy.

This actor is for cars, vans, and utilities only — not motos, and not the rest of the OLX marketplace.

Use structured filters — the same ones as the OLX cars listing; structured filters work better for AI agents — or paste an input_url once you've already filtered in the browser. When input_url is set it overrides the filters below.

OLX lists hundreds of thousands of car ads. This actor reads the public cars listing payload and returns up to 2000 rows per run.

💡 Perfect for...

• Agents: Export Toyota automatics from 2018+ without paging the site.
• Dashboards: Track price, year, km, fuel, and city.
• Market research: Slice body type, color, advertiser, FIPE, and inspection flags.
• Data analysts: Export structured OLX car rows with public ad URLs.
• 🤖 AI Agents: Power Claude, Cursor, Codex, the Hermes Agent, and OpenClaw workflows with live OLX car results.
• 📚 RAG Systems: Feed titles, specs, and locations into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste /autos-e-pecas/carros-vans-e-utilitarios/toyota (input_url) if you already filtered in the browser, or use dropdowns (better for AI agents). input_url always wins when set.
• 🎯 Website-Matched Filters: Same Marca, Modelo, Versão, Preço, Ano, Quilometragem, Câmbio, Combustível, Tipo, Cor, Portas, Direção, Motor, Opcionais, Aceita Trocas, Kit GNV, Estado financeiro, Documentação, Conservação, Final de placa, Tipo de anunciante, Ordenar, Festival de Carros, Histórico veicular, Vistoriado, and Ofertas abaixo da FIPE as olx.com.br.
• 🌐 Nationwide: All 27 UF slugs (estado-sp, estado-rj, …). Prefer www.olx.com.br/estado-sp/... over city subdomains.

📦 What's inside the data?

Every row includes listing fields from the public cars payload:

• Core: id, url, title, category, price, old_price, currency (BRL), price_reduction, installments
• Vehicle: make, model, year, mileage_km, body_type, engine, fuel, transmission, steering, color, doors, plate_end, features
• Condition: single_owner, accepts_trade, gnv_kit, owner_manual, spare_key, warranty, dealership_serviced, ipva_paid, has_fines, auction, settled, financed, financial_status, documentation, conservation, festival
• Place / seller: location, city, neighbourhood, state, ddd, professional_ad, seller, seller_rating
• Flags / media: featured, fixed_on_top, inspected, vehicle_history, vehicle_tags, vehicle_pills, condition_report_status, condition_report_date, published_at, image_url, image_count, video_count, view360_url

🚀 Quick start

Option A — Input URL

1. Open OLX cars, apply filters, copy the URL — e.g. https://www.olx.com.br/autos-e-pecas/carros-vans-e-utilitarios/toyota?rs=2018&gb=2.
2. Paste it into input_url.
3. Set max_results and click Start.

Option B — Structured filters (better for AI agents)

1. Leave input_url empty.
2. Pick make, year, transmission, state, and any other cars filters.
3. Set max_results (up to 2000) and click Start.

---

Tech details for developers 🧑‍💻

Input Example (filters):

{
  "make": "toyota",
  "transmission": "automatico",
  "year_min": 2018,
  "state": "sp",
  "max_results": 100
}

Input Example (URL override):

{
  "input_url": "https://www.olx.com.br/autos-e-pecas/carros-vans-e-utilitarios/toyota?rs=2018&gb=2",
  "max_results": 50
}

Output Example:

{
  "id": "1527847223",
  "url": "https://pi.olx.com.br/regiao-de-teresina-e-parnaiba/autos-e-pecas/carros-vans-e-utilitarios/toyota-hilux-sw4-srx-plat-4x4-2-8-tb-die-aut-2024-1527847223",
  "title": "Toyota Hilux SW4 SRX Plat. 4X4 2.8 TB Die. Aut. 2024",
  "category": "Carros, vans e utilitários",
  "price": 349900,
  "old_price": null,
  "currency": "BRL",
  "price_reduction": false,
  "installments": false,
  "make": "Toyota",
  "model": "Toyota SW4 SRX Plat. 4X4 2.8 TB Die. Aut.",
  "year": 2024,
  "mileage_km": 30000,
  "body_type": "SUV",
  "engine": "2.0 - 2.9",
  "fuel": "Diesel",
  "transmission": "Automático",
  "steering": "Hidráulica",
  "color": "Branco",
  "doors": "4 portas",
  "plate_end": "1",
  "features": "Air bag, Ar condicionado, Alarme, Bancos de couro, Câmera de ré, Computador de bordo, Conexão USB, Controle automático de velocidade, Navegador GPS, Rodas de liga leve, Sensor de ré, Som, Tração 4x4, Trava elétrica, Vidro elétrico, Volante multifuncional",
  "single_owner": null,
  "accepts_trade": null,
  "gnv_kit": false,
  "owner_manual": true,
  "spare_key": true,
  "warranty": null,
  "dealership_serviced": null,
  "ipva_paid": true,
  "has_fines": false,
  "auction": false,
  "settled": true,
  "financed": false,
  "financial_status": "Quitado",
  "documentation": "IPVA Pago",
  "conservation": "Com manual, Chave reserva",
  "festival": false,
  "location": "Teresina - PI",
  "city": "Teresina",
  "neighbourhood": "São Cristóvão",
  "state": "PI",
  "ddd": "86",
  "professional_ad": false,
  "seller": "João da silveira terto",
  "seller_rating": null,
  "featured": true,
  "fixed_on_top": false,
  "inspected": false,
  "vehicle_history": true,
  "vehicle_tags": ["vehiclehistory"],
  "vehicle_pills": ["IPVA pago"],
  "condition_report_status": null,
  "condition_report_date": null,
  "published_at": "2026-09-03T22:38:16+00:00",
  "image_url": "https://img.olx.com.br/images/59/592653792972449.jpg",
  "image_count": 7,
  "video_count": 0,
  "view360_url": null
}

Output fields:

Field	Description
id	OLX listId.
url	Public ad URL.
title	Ad headline (subject).
category	Always cars, vans, and utilities on this actor.
price	Asking price as a number.
old_price	Previous price when OLX shows a reduction.
currency	Always BRL.
price_reduction	Whether the ad has a price-drop badge.
installments	Whether installments are advertised.
make	Vehicle brand.
model	Vehicle model / version string.
year	Model year.
mileage_km	Odometer in kilometres.
body_type	Hatch, Sedã, SUV, Pick-up, …
engine	Motor range, e.g. 1.5 or 2.0 - 2.9.
fuel	Gasolina, Flex, Diesel, Híbrido, Elétrico, …
transmission	Manual, Automático, Semi-Automático, Automatizado.
steering	Hidráulica, Elétrica, …
color	Body color.
doors	Door count label.
plate_end	Final de placa.
features	Opcionais string from the listing.
single_owner	Único dono when published.
accepts_trade	Aceita trocas when published.
gnv_kit	Kit GNV flag.
owner_manual	Com manual.
spare_key	Chave reserva.
warranty	Com garantia.
dealership_serviced	Revisões em concessionária.
ipva_paid	IPVA pago.
has_fines	Com multas.
auction	De leilão.
settled	Quitado.
financed	Financiado.
financial_status	Indexed financial status label.
documentation	Documentação e regularização.
conservation	Conservação e garantia.
festival	Festival de Carros flag.
location	Combined location string.
city	Municipality.
neighbourhood	Neighbourhood.
state	UF, e.g. SP.
ddd	Area code.
professional_ad	Professional vs private advertiser.
seller	Seller name from the listing payload.
seller_rating	OLX Pay seller rating when present.
featured	Featured / bumped ad.
fixed_on_top	Pinned to the top of the list.
inspected	Vistoriado / inspection report.
vehicle_history	Histórico veicular tag.
vehicle_tags	Raw tag slugs from the payload.
vehicle_pills	Badge labels shown on the card.
condition_report_status	Inspection report status when present.
condition_report_date	Inspection report timestamp when present.
published_at	Ad date as ISO-8601 UTC.
image_url	First photo.
image_count	Photo count.
video_count	Video count.
view360_url	360 view URL when published.

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	No	—	Paste an OLX cars listing URL; overrides filters when set.
query	string	No	—	Same as the OLX search box (?q=).
make	string enum	No	all	Same Marca slugs as the cars page (toyota, gm-chevrolet, vw-volkswagen, …).
model	string	No	—	Same Modelo path after make (corolla).
version	string	No	—	Same Versão filter (vv=).
state	string enum	No	all	All 27 UF slugs (sp, rj, mg, …).
year_min / year_max	integer	No	—	Same Ano por intervalo (rs= / re=).
price_min / price_max	integer	No	—	Same Preço Min. / Máx. (ps= / pe=, BRL).
mileage_min / mileage_max	integer	No	—	Same Quilometragem (ms= / me=).
transmission	string enum	No	any	Same Câmbio (manual, automatico, semi-automatico, automatizado).
fuel	string enum	No	any	Same Combustível (gasolina, alcool, flex, diesel, hibrido, eletrico).
body_type	string enum	No	any	Same Tipo (hatch, seda, suv, pick-up, van-utilitario, perua, coupe, conversivel, caminhao-leve, buggy).
color	string enum	No	any	Same Cor (preto, branco, prata, vermelho, cinza, azul, amarelo, verde, laranja, outra).
doors	string enum	No	any	Same Portas (2, 3, 4).
steering	string enum	No	any	Same Direção (hidraulica, eletrica, mecanica, eletro-hidraulica).
engine	string enum	No	any	Same Motor (1.0 … 4.0-plus).
accepts_trade	string enum	No	any	Same Aceita Trocas (sim, nao).
feature	string enum	No	any	Same Opcionais (ar-condicionado, air-bag, teto-solar, tracao-4x4, …).
gnv_kit	string enum	No	any	Same Kit GNV (sim, nao).
financial_status	string enum	No	any	Same Estado financeiro (quitado, financiado).
documentation	string enum	No	any	Same Documentação (ipva-pago, com-multas, de-leilao).
conservation	string enum	No	any	Same Conservação (unico-dono, com-manual, chave-reserva, revisoes-concessionaria, com-garantia).
plate_end	string enum	No	any	Same Final de placa (0–9).
advertiser	string enum	No	any	Same Tipo de anunciante (particular, profissional).
sort	string enum	No	relevance	Same Ordenar por (relevance, date, price, biggest_price).
festival	boolean	No	false	Same Festival de Carros toggle (vt=1).
vehicle_history	boolean	No	false	Same Histórico veicular toggle (vtvh=).
inspected	boolean	No	false	Same Vistoriado toggle (crss=).
below_fipe	boolean	No	false	Same Ofertas abaixo da FIPE toggle (fpdll=).
max_results	integer	No	50	Maximum rows (1–2000).

Notes on filters

• Prefer exact enum strings from the Apify input dropdowns (same labels as OLX cars).
• Chevrolet is gm-chevrolet and Volkswagen is vw-volkswagen — those are the live OLX slugs.
• input_url always wins over filters when provided.
• www.olx.com.br, olx.com.br, and UF hosts such as sp.olx.com.br are accepted.
• This actor does not scrape motos or other OLX categories.

🔧 Custom scrapers and agents

If you need a custom web scraper, or custom AI agents and workflows, contact me through tuik.ai. We help businesses cut costs and time by up to 10x.