# πŸ‡§πŸ‡· OLX Brazil Scraper | Classified Ads, Prices & Leads (`plum_spear/aztec-olx`) Actor Scrape OLX Brazil classified ads by keyword, category or region. Returns title, price, location, category, date and ad URL as clean structured data. - **URL**: https://apify.com/plum\_spear/aztec-olx.md - **Developed by:** [Roberto Kerber](https://apify.com/plum_spear) (community) - **Categories:** E-commerce, Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.15 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 - Extract Classified Ads, Prices & Listings Data **Scrape OLX Brazil (olx.com.br) at scale.** This OLX scraper extracts structured data from classified ads across all of Brazil - by keyword, region, or any OLX search/category URL. Get clean JSON for every listing: title, parsed price in BRL, location, category, date, image count, seller type, and the ad URL. Built for price monitoring, market research, lead generation, and reselling - the OLX classifieds API alternative that just works. No setup headaches, no blocked requests. The scraper handles OLX reliably and returns ready-to-use data you can pipe straight into a spreadsheet, dashboard, or database. Run it once for a snapshot, or **schedule it to run daily or weekly** to monitor how prices and listings change over time - the difference between a one-off export and a living OLX price feed. Built to run on a **residential IP**, so it reaches listings that block datacenter scrapers - and keeps reaching them run after run, day after day. --- ### What does it do? The **OLX Brazil Scraper** turns the largest classifieds marketplace in Brazil into a structured data source. Instead of copying listings by hand, you give it a search term, a region, or a full OLX URL, and it returns every matching ad as clean JSON. It is the fastest way to **scrape OLX listings** for any product, service, vehicle, or property category - whether you are tracking competitor prices, building a market analysis, generating sales leads, or hunting for underpriced inventory to flip. Prices arrive already parsed as numbers (not messy strings), so you can sort, filter, and run calculations the moment the run finishes. Location is broken down into municipality, neighbourhood, state, and area DDD code, making geographic analysis trivial. --- ### Features - πŸ”Ž **Search by keyword** - scrape OLX for any term like `iphone 15 pro`, `apartamento`, `civic`, `geladeira`, or `notebook` - πŸ—ΊοΈ **Filter by region** - target the whole country (`brasil`) or a specific state (`estado-sp`, `estado-rj`, etc.) - πŸ”— **Paste any OLX URL** - feed a full search or category URL straight from olx.com.br for pixel-perfect targeting - πŸ’° **Prices parsed as numbers** - get `price: 3900` in BRL plus the original `priceText`, ready for filtering and analysis - πŸ“ **Detailed location data** - municipality, neighbourhood, state, and DDD area code for every ad - 🏷️ **Seller insights** - know whether a listing is a professional/business ad or a private seller - πŸ–ΌοΈ **Image metadata** - image count and thumbnail URL for each listing - πŸ“„ **Automatic pagination** - collect as many ads as you need up to your `maxAds` limit - 🧾 **Clean, flat JSON** - no nested mess; every record is dashboard- and database-ready - ⚑ **Reliable extraction** - handles OLX reliably with no blocked requests, no proxy configuration, no maintenance --- ### Use cases Whatever your reason for needing **OLX Brazil data**, this scraper covers it: #### πŸ’° Price monitoring Track how much products sell for across Brazil and watch prices move over time. Schedule runs to monitor a category daily and get alerted when something drops below your target. Ideal for repricing strategies and competitive intelligence. **Can you monitor prices on OLX? Yes** - that is exactly what this actor is built for. #### πŸ“Š Market research Measure supply and demand in any niche. Pull thousands of listings for a category and analyze average price, price spread, geographic distribution, and the share of professional vs. private sellers. Perfect for business analysts, consultants, and founders validating a market. #### 🎯 Lead generation Find sellers and businesses advertising in your target niche. Extract contact context (location, DDD area code, professional-ad flag) at scale to build prospecting lists for sales teams. A practical **OLX lead generation** engine for B2B outreach. #### πŸ” Resellers & arbitrage Spot underpriced items the moment they are posted. Compare OLX prices against marketplace or retail benchmarks and flip the gap. With numeric prices and fast runs, you can build an automated deal-finder for your reselling business. #### 🏠 Real estate professionals Scrape apartment, house, and land listings (`apartamento`, `casa`, `terreno`) by city or state. Analyze asking prices per neighbourhood, track new inventory, and benchmark your own listings against the local market. #### πŸš— Car dealers & auto traders Monitor used-car listings (`civic`, `corolla`, `hb20`, `onix`) across regions. Track depreciation, find acquisition opportunities, and price your stock against live market data from OLX's auto category. --- ### Automate it: scheduled price & listing monitoring A single run gives you a snapshot. The real value of OLX data is in the **change over time** - prices move, stock turns over, and new ads appear every hour. Put this scraper on a schedule and it becomes an always-on monitoring engine instead of a manual export. #### Daily price feed (repricing & arbitrage) Schedule a category to run **`@daily`** and watch the market move. Track average, minimum, and median price for a term like `iphone 15 pro` or `civic`, store each run's results, and get alerted the moment a listing drops below your target price. This is the backbone of any repricing strategy or reselling/arbitrage operation - you find the deal before anyone refreshing the page by hand does. #### New listings watch (lead gen & deal hunting) Run on a tight schedule (for example **every hour** or several times a day) and diff each result set against the last by `listId`. New IDs are brand-new ads - pipe them straight to Slack or email so you see fresh inventory and new sellers the instant they post. Perfect for snapping up underpriced items first, or for building a real-time lead list of professional sellers in your niche. #### Weekly market report Schedule a broad run **`@weekly`** to measure the market itself: total ad volume per niche, price distribution, share of professional vs. private sellers, and geographic spread by state and DDD area code. Drop it into a Google Sheet or dashboard to track supply, demand, and pricing trends week over week. #### How to set it up 1. **Apify Scheduler** - open your saved task, add a schedule with a cron expression (for example `0 8 * * *` for every day at 08:00), and the actor runs itself on autopilot. No server, no cron box to maintain. 2. **Pipe the results anywhere** - connect the run to **Make, Zapier, or n8n** to push every dataset into Slack, email, Google Sheets, Airtable, or your own database. 3. **Add alerts** - in your automation tool, filter the output (for example `price < 3000`) and fire a notification only when something matches. That turns a daily scrape into a price-drop alert that pays for itself. Set it once and the data keeps arriving - recurring price monitoring, recurring lead gen, recurring market intelligence, all without touching it again. --- ### Input Configure the scraper with a few simple fields: | Field | Type | Description | Example | |-------|------|-------------|---------| | `term` | string | Search keyword to look up on OLX Brazil | `iphone 15 pro` | | `url` | string | Full OLX search or category URL (advanced - overrides `term`) | `https://www.olx.com.br/...` | | `region` | string | OLX region slug to scope the search | `brasil`, `estado-sp` | | `maxAds` | number | Maximum number of ads to scrape | `100` | #### Example input ```json { "term": "iphone 15 pro", "region": "brasil", "maxAds": 100 } ```` You can search the whole country, narrow down to a state, or paste a precise OLX URL when you have already applied filters on the website. *** ### Example output Each ad is returned as a flat JSON object: ```json { "listId": 1455857240, "title": "iPhone 15 Pro 256GB TitΓ’nio Natural", "price": 3900, "priceText": "R$ 3.900", "oldPrice": null, "category": "Celulares e telefonia", "municipality": "TubarΓ£o", "neighbourhood": "Centro", "state": "SC", "ddd": "48", "date": "2026-06-17T14:32:00", "imageCount": 6, "professionalAd": false, "url": "https://www.olx.com.br/...", "thumbnail": "https://img.olx.com.br/..." } ``` *** ### Output fields Every listing includes the following fields: | Field | Description | |-------|-------------| | `listId` | Unique OLX listing ID | | `title` | Ad title | | `price` | Price parsed as a number (BRL) | | `priceText` | Original price string, e.g. `R$ 3.900` | | `oldPrice` | Previous price when the ad shows a markdown | | `category` | OLX category name | | `municipality` | City of the listing | | `neighbourhood` | Neighbourhood of the listing | | `state` | State (UF) | | `ddd` | Area phone code (DDD) | | `date` | Publication date | | `imageCount` | Number of images on the ad | | `professionalAd` | `true` for professional/business sellers, `false` for private | | `url` | Direct link to the ad | | `thumbnail` | Thumbnail image URL | *** ### Frequently asked questions #### How do I scrape OLX Brazil? Set a `term` (for example `notebook`), pick a `region` such as `brasil` or `estado-sp`, choose how many ads you want with `maxAds`, and run the actor. You will get structured JSON for every matching listing - no coding, browser, or proxy setup required. For precise targeting, paste a full OLX search URL into the `url` field instead. #### Can I monitor prices on OLX? Yes. Because prices come parsed as numbers, OLX price monitoring is straightforward: schedule the scraper to run on a category, store the results over time, and track how prices change. It is ideal for repricing, competitive analysis, and deal alerts. #### Can I monitor OLX prices on a schedule? Yes - that is where this actor earns its keep. Use the built-in **Apify Scheduler** to run it on a cron schedule (for example `0 8 * * *` for daily at 08:00), so it scrapes a category automatically without you lifting a finger. Connect the runs to **Make, Zapier, or n8n** to push results into Slack, email, or Google Sheets, and add a filter (such as `price < target`) so you get a **price-drop alert** the moment a listing falls below your threshold. The same setup powers a new-listings watch for lead generation - schedule frequent runs, diff by `listId`, and surface fresh ads as soon as they are posted. #### Can I scrape a specific OLX category or filtered search? Yes. Apply any filters you want directly on olx.com.br, copy the resulting URL, and paste it into the `url` field. The scraper will follow that exact search or category and paginate through the results up to your limit. #### What data does the OLX scraper return? For each ad you get the listing ID, title, numeric price and original price text, previous price, category, full location (municipality, neighbourhood, state, DDD), publication date, image count, professional-ad flag, the ad URL, and a thumbnail. #### Is there a free tier? Apify gives new users free monthly platform credits, so you can test the OLX scraper at no cost before scaling up. After that you only pay per event (see pricing below) with no subscription and no minimums. #### Can I use this for lead generation? Absolutely. Filter by niche and region, then export sellers along with their location, DDD area code, and professional/private status to build targeted prospecting lists for your sales pipeline. #### Is scraping OLX reliable? Yes. The scraper handles OLX reliably with no blocked requests, so you get complete result sets without managing proxies or worrying about failed runs. #### How many ads can I scrape? As many as you need - set the `maxAds` field to control the volume per run. The scraper paginates automatically until it reaches your limit. *** ### Pricing **Pay per event: $0.15 per 1,000 ads returned, plus a minimal actor-start event.** No subscription, no monthly minimums - you only pay for the data you actually extract. Combined with Apify's free monthly credits for new users, you can start scraping OLX Brazil today and scale exactly to your needs. *** **Keywords:** OLX scraper, OLX Brazil scraper, OLX classifieds API, scrape OLX listings, OLX price monitoring, scheduled OLX scraper, OLX price tracker, OLX price alerts, new listings monitor, Brazil classified ads scraper, OLX lead generation, OLX data extraction, olx.com.br scraper. # Actor input Schema ## `term` (type: `string`): Keyword to search on OLX Brazil, e.g. 'notebook', 'apartamento', 'civic'. ## `url` (type: `string`): A full OLX search/category URL. Overrides the search term and region if set. ## `region` (type: `string`): OLX region slug (e.g. 'brasil', 'estado-sp', 'rio-de-janeiro'). ## `maxAds` (type: `integer`): Maximum number of ads to scrape. ## `scraperEndpoint` (type: `string`): Residential scraping endpoint URL. Leave default unless you run your own. ## `scraperApiKey` (type: `string`): API key for the residential scraping endpoint. ## Actor input object example ```json { "region": "brasil", "maxAds": 100 } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("plum_spear/aztec-olx").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("plum_spear/aztec-olx").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call plum_spear/aztec-olx --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=plum_spear/aztec-olx", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "πŸ‡§πŸ‡· OLX Brazil Scraper | Classified Ads, Prices & Leads", "description": "Scrape OLX Brazil classified ads by keyword, category or region. Returns title, price, location, category, date and ad URL as clean structured data.", "version": "0.1", "x-build-id": "Pmouh8ZoDRuQutnks" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plum_spear~aztec-olx/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plum_spear-aztec-olx", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/plum_spear~aztec-olx/runs": { "post": { "operationId": "runs-sync-plum_spear-aztec-olx", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/plum_spear~aztec-olx/run-sync": { "post": { "operationId": "run-sync-plum_spear-aztec-olx", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "term": { "title": "Search term", "type": "string", "description": "Keyword to search on OLX Brazil, e.g. 'notebook', 'apartamento', 'civic'." }, "url": { "title": "Start URL (advanced)", "type": "string", "description": "A full OLX search/category URL. Overrides the search term and region if set." }, "region": { "title": "Region", "type": "string", "description": "OLX region slug (e.g. 'brasil', 'estado-sp', 'rio-de-janeiro').", "default": "brasil" }, "maxAds": { "title": "Max ads", "minimum": 1, "type": "integer", "description": "Maximum number of ads to scrape.", "default": 100 }, "scraperEndpoint": { "title": "Scraper endpoint (advanced)", "type": "string", "description": "Residential scraping endpoint URL. Leave default unless you run your own." }, "scraperApiKey": { "title": "Scraper API key", "type": "string", "description": "API key for the residential scraping endpoint." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```