# OLX  Scraper | Ads, Prices & Cities (`lentic_clockss/olx-br-scraper`) Actor

Scrape OLX guest classifieds from olx.com.br: keyword search, São Paulo or nationwide, cell-phone category pages, and listing detail. Get listId, title, BRL price, city, UF, images and category. Export Excel, CSV or JSON. No seller name, phone, or chat.

- **URL**: https://apify.com/lentic\_clockss/olx-br-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## OLX Brazil Scraper | Ads, Prices & Cities

**Scrape [OLX Brazil](https://www.olx.com.br) classified ads from `olx.com.br` — keyword search, São Paulo or nationwide, cell-phone category pages, and listing detail — then download structured results as Excel, CSV, or JSON.**

Use this Actor as a practical **OLX Brazil scraper / olx.com.br data API** for **price monitoring**, **classifieds research**, and **inventory watches**. Enter a Portuguese keyword, pick `brasil` or `estado-sp`, and get Dataset rows with `listId`, title, BRL price, city, UF, images, and live listing URLs.

- **Keyword search** on `/brasil?q=` or `/estado-sp?q=` (path is the market switch, not `state=`)
- **Leaf category** listings on `/celulares` (optional keyword `q=` on the same ads\[] channel)
- **Listing detail** from live `ads[].url` (`{uf}.olx.com.br/...-{listId}`) — keep list `priceValue` and detail `offerPrice` separate
- Guest HTML only — **no seller name, phone, neighborhood, zip, or chat**
- Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or the Apify API
- **Pay per event** — Actor start + each Dataset result; **platform usage is included** (you do not pay separate Apify compute on top)

> **Unofficial tool.** This Actor is not affiliated with, endorsed by, or sponsored by OLX. It collects **guest / public** classified pages and does **not** log in, open chat, or scrape private account data.

***

### What does the OLX Brazil Scraper do?

[OLX Brazil Scraper](https://apify.com/lentic_clockss/olx-br-scraper) lets you **extract structured olx.com.br listings** without running your own Brazilian residential proxy and anti-bot stack. Give it a search query, a `celulares` category run, or a batch of live listing URLs, then start a run.

Under the hood, the Actor:

1. Validates your input (`searchType`, region, category slug, URLs)
2. Enforces free-tier caps when you are on a free Apify plan
3. Calls a managed worker that fetches guest OLX HTML (Chrome TLS + residential egress)
4. Parses Next.js RSC `ads[]` (lists) and adview-v3 `adDetail` / JSON-LD (detail)
5. Writes Dataset rows plus `INPUT_ECHO`, `RUN_SUMMARY` (and `ERROR_SUMMARY` on failure) to the key-value store

You run it like any other Apify Actor — schedule it, call it from the API, or plug it into automations.

***

### What OLX Brazil data can I extract?

| Data | Keyword search | `/celulares` category | Listing detail |
| --- | :---: | :---: | :---: |
| `listId` / live URL | ✅ | ✅ | ✅ |
| Title (`subject`) | ✅ | ✅ | ✅ |
| List price (`priceValue` / BRL) | ✅ | ✅ | — |
| Detail offer price (`offerPrice`, `offerCurrency`) | — | — | ✅ |
| City / UF | ✅ | ✅ | ✅ |
| Category name + `properties[]` | ✅ | ✅ | varies |
| Images (`img.olx.com.br`) | ✅ | ✅ | ✅ |
| `professionalAd` / OLX Pay / delivery flags | ✅ | ✅ | varies |
| Seller name / phone / chat | ❌ | ❌ | ❌ |
| Neighborhood / zip | ❌ | ❌ | ❌ |

**Identity key is `listId`, not `adId`.** Do not invent detail URLs from `adId`. Skip home recommend cards at `/vi/{id}` — those are not listing detail pages.

***

### Why scrape OLX Brazil?

OLX Brazil (`olx.com.br`) is the country’s largest **classifieds marketplace** for used goods. Teams scrape it to:

- Watch **asking prices** for a keyword (bikes, appliances, instruments) nationwide or in São Paulo
- Pull **cell-phone category** cards (`/celulares`) with or without a keyword
- Follow **listing URLs** for JSON-LD offer price when list price and detail price differ
- Feed CRM-adjacent catalogs, BI dashboards, Google Sheets, BigQuery, or AI agents with clean rows — **without** seller PII

Compared with generic URL scrapers, this Actor returns **OLX-specific fields** (`listId`, `priceValue`, `uf`, `categoryName`, `listPageUrl`) in one input surface.

Honest scope: **nationwide + São Paulo search**, **`/celulares`**, and **detail follow** are opened. Other Brazilian states, vehicle/real-estate leaf categories, seller stores, and other-country OLX sites stay in the schema but **fail-fast** until measured — they are not filled with empty “success” rows.

***

### More Actors like this

Need Mercado Libre, other classifieds, e-commerce catalogs, or a generic protected-page scrape? Use a **dedicated Actor** below for structured fields. Use this Actor for **OLX Brazil** (`olx.com.br`) guest search, `/celulares`, and listing detail.

#### Similar classifieds & marketplace scrapers

- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper) — LATAM marketplace listings & prices
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper) — Mercari.jp classifieds
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper) — Allegro.pl marketplace
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper) — Norwegian classifieds
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper) — US housing ads
- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper) — generic protected pages (prefer a dedicated Actor when one exists)

#### Prefer another specialized scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic scrape.

**E-commerce**

- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)

**Real Estate**

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [Properati LATAM](https://apify.com/lentic_clockss/properati-scraper) — CO / AR / PE / EC listings
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)

**Jobs & Freelance**

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)

**General Tools**

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)

→ See the full catalog in [Related Actors](#related-actors) below, or browse [apify.com/lentic\_clockss](https://apify.com/lentic_clockss).

***

### How to scrape OLX Brazil (no code required)

1. Create a free [Apify](https://apify.com/) account
2. Open [OLX Brazil Scraper](https://apify.com/lentic_clockss/olx-br-scraper)
3. Choose **searchType**: `search`, `category`, or `detail`
4. For search: enter a **Portuguese keyword** (`query`) and **region** (`brasil` or `estado-sp`)
5. For category: set `categorySlug` to `celulares` (optional `query` on the same page)
6. *(Optional)* Turn on `enrichDetails` to follow listing URLs (clamps `maxPages` to 3)
7. Click **Start** and download the Dataset as JSON, CSV, Excel, or JSONL

Start with `maxResults: 5–15` to verify the query, then scale up. Empty `{}` runs a tiny national search for `sofa` so the platform auto-test succeeds — for real jobs, pass a fresh keyword.

#### Search ads by keyword

**In plain English:** pick nationwide or São Paulo and a product noun → get a table of matching ads with `listId` and BRL price.

**You give:** `searchType=search`, `query=bicicleta`, `region=estado-sp`, `maxResults=20`.

#### Scrape the cell-phones category

**In plain English:** open `/celulares` → listing cards on the same ads\[] channel. Add `query` to search inside that leaf.

**You give:** `searchType=category`, `categorySlug=celulares`, optional `query=samsung`.

#### Follow listing detail URLs

**In plain English:** pass live `{uf}.olx.com.br/...-{listId}` URLs from a previous search → merge `adDetail` / JSON-LD offer price. Do **not** invent ids or paste `/vi/{id}` home cards.

#### Feed AI agents and automations

**In plain English:** start the Actor from Make, n8n, Zapier, LangChain, or the Apify API → Dataset rows are structured JSON (`listId`, `subject`, `priceValue`, `url`, `city`, `uf`).

***

### How much does it cost to scrape OLX Brazil?

This Actor uses **pay-per-event** pricing. You are charged for:

| Event | Price |
| --- | --- |
| Actor Start (`apify-actor-start`) | **$0.005** per start |
| Result (`apify-default-dataset-item`) | **$3.00 / 1,000** results (**$0.003** each on FREE/BRONZE) |

**Platform usage costs are included** — you do **not** pay separate Apify compute/proxy usage for this Actor on top of the event prices above (**User pays platform usage costs = No**).

#### Volume discount tiers (per result)

| Tier | $/1,000 | per result |
| --- | ---: | ---: |
| FREE\* | $3.00 | $0.003 |
| BRONZE | $3.00 | $0.003 |
| SILVER | $2.60 | $0.0026 |
| GOLD | $2.20 | $0.0022 |
| PLATINUM | $2.00 | $0.002 |
| DIAMOND | $1.60 | $0.0016 |

\*FREE matches BRONZE for this Actor.

#### Example cost estimates (FREE/BRONZE)

| Results collected | Approx. event cost\* |
| --- | ---: |
| 100 | ~$0.31 |
| 1,000 | ~$3.01 |
| 10,000 | ~$30.01 |

\*Assumes one Actor start at default memory billing for start events, plus `$0.003` per Dataset item. Exact start billing can scale with allocated memory (one start event per GB, minimum one). Default memory is **1024 MB**.

#### Free plan limits

On a **free Apify plan**, this Actor enforces developer limits of **10 runs** and **200 results per run**. Upgrade to a paid Apify plan for unlimited runs (event prices still apply).

***

### Input examples

#### Keyword search (São Paulo)

```json
{
  "query": "bicicleta",
  "searchType": "search",
  "region": "estado-sp",
  "maxResults": 20,
  "maxPages": 1
}
```

#### Nationwide search

```json
{
  "query": "geladeira",
  "searchType": "search",
  "region": "brasil",
  "maxResults": 20,
  "maxPages": 1
}
```

#### Cell-phones category (optional keyword)

```json
{
  "searchType": "category",
  "categorySlug": "celulares",
  "query": "samsung",
  "maxResults": 15,
  "maxPages": 1
}
```

#### Listing detail follow

```json
{
  "searchType": "detail",
  "detailUrls": [
    "https://sp.olx.com.br/grande-campinas/ciclismo/bicicleta-schwinn-1402539953"
  ],
  "enrichDetails": true
}
```

Use a **live** URL from a previous Dataset row. Do not hand-build from `adId`.

***

### FAQ

#### How do I scrape OLX Brazil listings?

Open this Actor, pick `search` or `category`, set `query` / `region` / `categorySlug`, and click Start. Export the Dataset as CSV, Excel, or JSON. You can also call it as an **OLX Brazil API** via the Apify REST API or Python/JavaScript clients.

#### Do I need an OLX account or API key?

No. This Actor reads **guest** `olx.com.br` pages. You do not log in, and you do not pass an OLX developer key.

#### Which regions are supported?

**Opened:** `brasil` (nationwide path) and `estado-sp` (São Paulo). Other `estado-*` values stay in the input enum so the coverage matrix is visible, but they **fail-fast** until a Cloud Run smoke returns `listId≥1`. Do not assume São Paulo implies Rio or Minas.

#### Can I scrape cars or real estate?

Not on this build. `searchType=vehicles` and `searchType=realestate` fail-fast. Category hubs (`autos-e-pecas`, `imoveis`) are not listing pages. Use a dedicated vehicles Actor if you need car filters / FIPE.

#### Can I get seller phone numbers or names?

No. OLX hides contact behind login/chat. This Actor **strips** seller name, phone, neighborhood, zip, and chat on purpose (LGPD-friendly guest fields only).

#### Why did empty `{}` search for sofa?

The national home without `q=` is not a list. Schema default `query=sofa` makes the platform auto-test a real `/brasil?q=sofa` search. For production, pass your own Portuguese keyword.

#### Is scraping OLX legal?

This Actor collects publicly reachable guest pages. You are responsible for how you use the data (including Brazil’s LGPD). This is an unofficial third-party tool.

#### Is this affiliated with OLX?

No.

***

### Input reference

| Parameter | Type | Description |
| --- | --- | --- |
| `query` | string | Keyword for `search` (default `sofa`). Portuguese product nouns work best |
| `searchType` | string | `search` | `category` | `detail` | `hub` (hub returns leaf slugs, not ads) |
| `region` | string | Opened: `brasil`, `estado-sp`. Other UFs fail-fast |
| `categorySlug` | string | Opened leaf: `celulares`. Hubs rejected |
| `detailUrls` | array | Live `{uf}.olx.com.br/...-{listId}` URLs |
| `maxResults` | integer | Cap Dataset rows (free plan ≤ 200) |
| `maxPages` | integer | List pager `o=` from 1; ~50 cards/page; cap 8 |
| `enrichDetails` | boolean | Follow listing URLs; clamps `maxPages` to 3 |
| `priceMin` / `priceMax` | integer | Optional list query `ps=` / `pe=` (BRL) |
| `sort` | string | Optional sort query; omit for site default |

Full output schema is available in the Dataset tab. Key-value records: `INPUT_ECHO`, `RUN_SUMMARY`, `ERROR_SUMMARY` (no internal worker URLs).

***

### Connect to your tools

| Platform | How to connect |
| --- | --- |
| **Make.com** | Search "Apify" → "Run Actor" → Actor ID: `lentic_clockss/olx-br-scraper` |
| **n8n** | Add Apify node → "Run Actor" → same Actor ID |
| **Zapier** | Apify integration → "Run Actor" |
| **Python / Node.js** | Apify SDK or direct HTTPS call |

#### API call example

```bash
curl "https://api.apify.com/v2/acts/lentic_clockss~olx-br-scraper/runs" \
  -X POST \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"bicicleta","searchType":"search","region":"estado-sp","maxResults":10}'
```

Results:

```http
GET https://api.apify.com/v2/datasets/{datasetId}/items?format=json
```

***

### Live-view Standby API

This Actor enables Apify Standby and ships `.actor/openapi.json` for Live-view:

- `GET /` / `GET /health` — Actor readiness (no scrape)
- `GET /input-example` — safe low-cost example input
- `GET /openapi.json` — OpenAPI document
- `POST /search` — optional Live-view preview (capped `maxResults`); persist production results with a **normal Actor run**

Full jobs should be launched as normal Apify Actor runs so Dataset rows plus `INPUT_ECHO`, `RUN_SUMMARY`, and `ERROR_SUMMARY` are persisted.

***

### Runtime

| Setting | Value |
| --- | --- |
| Default memory | **1024 MB** |
| Timeout default | **3600 s** |
| Standby | Enabled (lightweight Live-view) |
| Free plan caps | **10 runs** / **200 results** per run |
| Content depth | **guest** (no OLX login) |

***

### Related Actors

All public Actors from [lentic\_clockss](https://apify.com/lentic_clockss). Click a name to open the Store detail page.

#### Classifieds & Marketplaces

- [OLX Brazil Scraper](https://apify.com/lentic_clockss/olx-br-scraper) — OLX Brazil search, `/celulares` & listing detail (this Actor)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper)
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper)

#### Apps & ASO

- [Apple App Store Scraper](https://apify.com/lentic_clockss/apple-app-store-scraper) — Apple App Store search, charts, reviews & app details

#### E-commerce

- [Watsons Product Scraper](https://apify.com/lentic_clockss/watsons-scraper)
- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)

#### Food Delivery

- [Grab Scraper](https://apify.com/lentic_clockss/grab-scraper) — GrabFood / GrabMart SEA
- [Foodpanda Scraper](https://apify.com/lentic_clockss/foodpanda-scraper) — Foodpanda APAC
- [Foodora Scraper](https://apify.com/lentic_clockss/foodora-scraper) — Foodora NO / SE / AT / HU / CZ
- [Uber Eats Scraper](https://apify.com/lentic_clockss/ubereats-scraper) — multi-locale Uber Eats
- [Deliveroo Scraper](https://apify.com/lentic_clockss/deliveroo-scraper) — Deliveroo markets
- [DoorDash Scraper](https://apify.com/lentic_clockss/doordash-scraper) — DoorDash stores & menus
- [Wolt Scraper](https://apify.com/lentic_clockss/wolt-scraper) — Wolt restaurants & cities

#### Jobs & Freelance

- [Job Seek Career Jobs Monitor](https://apify.com/lentic_clockss/jseek-scraper)
- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Freelancer.com Scraper](https://apify.com/lentic_clockss/freelancer-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Himalayas Jobs Scraper](https://apify.com/lentic_clockss/himalayas-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Jobicy Remote Jobs Scraper](https://apify.com/lentic_clockss/jobicy-remote-jobs-scraper)
- [RemoteOK Jobs Scraper](https://apify.com/lentic_clockss/remoteok-all-jobs-scraper)
- [SEEK Jobs Scraper](https://apify.com/lentic_clockss/seek-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)

#### Real Estate

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [99.co Scraper](https://apify.com/lentic_clockss/ninetynine-co-sg-scraper)
- [Realtor.com Agents Scraper](https://apify.com/lentic_clockss/realtor-com-agents-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Bayut Scraper](https://apify.com/lentic_clockss/bayut-uae-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [Dot Property Scraper](https://apify.com/lentic_clockss/dot-property-th-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Hepsiemlak Scraper](https://apify.com/lentic_clockss/hepsiemlak-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Naver Land Scraper](https://apify.com/lentic_clockss/naver-land-scraper)
- [OpenSooq Scraper](https://apify.com/lentic_clockss/opensooq-real-estate-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Property Finder Scraper](https://apify.com/lentic_clockss/property-finder-uae-scraper)
- [PropertyGuru Scraper](https://apify.com/lentic_clockss/propertyguru-sg-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [SUUMO Scraper](https://apify.com/lentic_clockss/suumo-property-scraper)
- [Zillow Group Scraper](https://apify.com/lentic_clockss/zillow-group-scraper)
- [Properati LATAM Scraper](https://apify.com/lentic_clockss/properati-scraper)

#### Travel & Stays

- [Booking.com & Airbnb Scraper](https://apify.com/lentic_clockss/booking-airbnb-scraper)
- [Agoda Scraper](https://apify.com/lentic_clockss/agoda-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Travelstart Flights Scraper](https://apify.com/lentic_clockss/travelstart-scraper)
- [Trip.com Scraper](https://apify.com/lentic_clockss/trip-com-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

#### Social & Content

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)

#### Ads Intelligence

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [Google Ads Transparency VN](https://apify.com/lentic_clockss/google-ads-transparency-center-vn)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

#### Local & Maps

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General Tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ Browse the full profile: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

***

### Changelog

- **0.1.6** — Store README (SEO, How to use, pricing, More Actors, Related Actors). PPE: Actor Start $0.005 + result $3.00/1k with volume tiers. Platform usage paid by developer.
- **0.1.5** — Coverage: `estado-sp` search opened; `/celulares?q=`; hub href leaf discovery; MG/RJ and other leaves fail-fast.
- **0.1.3** — Fail-fast unverified surfaces; empty `{}` → `sofa`; `provider=engine_used`.
- **0.1** — Guest search, `/celulares`, listing detail. Identity `listId`.

# Actor input Schema

## `query` (type: `string`):

Keyword for searchType=search. Default sofa so empty {} and query="" hit /brasil?q=sofa (home without q= is not a list). Not iphone/celulares.

## `searchType` (type: `string`):

Opened: search, category (/celulares), detail. hub discovers href leaf slugs and is not a list. vehicles / realestate / seller / home / other-country fail-fast.

## `region` (type: `string`):

Market switch is a path, not state= query. Cloud Run opened: brasil, estado-sp. Other UFs including estado-mg and estado-rj fail-fast until measured.

## `categorySlug` (type: `string`):

Required for searchType=category. Opened leaf: celulares. Other leaves and hubs (eletronicos-e-celulares, autos-e-pecas, imoveis) fail-fast. searchType=hub returns discoveredLeaves from hrefs instead of listings.

## `maxResults` (type: `integer`):

Cap dataset rows (1–200). Free-plan users are capped by the Actor.

## `maxPages` (type: `integer`):

Pagination key o= from 1. About 50 cards/page. Capped at 8; enrichDetails clamps to 3 so the 850s worker timeout is not exhausted.

## `enrichDetails` (type: `boolean`):

If true, GET each ads\[].url and merge adDetail / JSON-LD price. List priceValue and detail offerPrice can differ — both are kept. Clamps maxPages to 3 so the worker timeout is not exhausted.

## `detailUrls` (type: `array`):

Full {uf}.olx.com.br listing URLs ending in -{listId}. Do not pass /vi/{id} home recommend cards or invent adId URLs.

## `priceMin` (type: `integer`):

Optional list filter query ps=. Side-evidence in recon; only use when you need a price floor.

## `priceMax` (type: `integer`):

Optional list query pe=.

## `sort` (type: `string`):

Optional sort query. Omit for site default (relevance).

## `workerBaseUrl` (type: `string`):

Optional. HTTPS Cloud Run origin only (\*.run.app). Auth is never sent to arbitrary hosts. Production uses Actor env WORKER\_BASE\_URL.

## Actor input object example

```json
{
  "query": "sofa",
  "searchType": "search",
  "region": "brasil",
  "categorySlug": "",
  "maxResults": 3,
  "maxPages": 1,
  "enrichDetails": false,
  "detailUrls": [],
  "sort": "",
  "workerBaseUrl": ""
}
```

# Actor output Schema

## `listings` (type: `string`):

Dataset of OLX Brazil classified listing rows

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "sofa",
    "searchType": "search",
    "region": "brasil",
    "categorySlug": "",
    "maxResults": 3,
    "maxPages": 1,
    "enrichDetails": false,
    "detailUrls": [],
    "sort": "",
    "workerBaseUrl": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/olx-br-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "sofa",
    "searchType": "search",
    "region": "brasil",
    "categorySlug": "",
    "maxResults": 3,
    "maxPages": 1,
    "enrichDetails": False,
    "detailUrls": [],
    "sort": "",
    "workerBaseUrl": "",
}

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/olx-br-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "sofa",
  "searchType": "search",
  "region": "brasil",
  "categorySlug": "",
  "maxResults": 3,
  "maxPages": 1,
  "enrichDetails": false,
  "detailUrls": [],
  "sort": "",
  "workerBaseUrl": ""
}' |
apify call lentic_clockss/olx-br-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lentic_clockss/olx-br-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/1JnwUvhsmnj0bngE2/builds/GMQ5fuuuL56HLmUiB/openapi.json