OLX Brazil Scraper 🇧🇷

The specialized scraper for OLX.com.br. Extract detailed listings including prices, locations, descriptions, and photos from Brazil's largest marketplace.

⚡ Pricing: Pay Per Result

No Subscription Fee. You only pay for the data you get.

• Pay Per Event: Costs are calculated based on the number of successful search results scraped.
• Cost-Effective: Filter your search to get exactly what you need.

---

🚀 Features

• Brazil Optimized: Specifically tuned for olx.com.br (Next.js structure) to capture 100% of listings.
• High Fidelity Data:
  • Full Prices: Extracts raw amounts and formatted display strings (R$).
  • High-Res Photos: Captures all available images.
  • Descriptions: Full body text extraction.
  • Location: City and State (Estado).
• Smart Pagination: Automatically traverses search results pages.
• Keyword Search: Search for any term (e.g., "Gol G5", "iPhone 15", "Aluguel").

---

🌟 More Scrapers from DaddyAPI

Check out our other specialized tools for scraping data:

Scraper	Description	Price
OLX Search Scraper (Global)	Supports Ukraine, Poland, Romania, Portugal, and more. The universal solution for OLX Europe.	Pay per result
OLX India Scraper	Dedicated scraper for olx.in. Optimized for India's specific data structure and anti-bot systems.	Pay per result
Generic Html Scraper	A lightweight, robust, and simple actor to fetch the raw HTML content of any URL. Perfect for building your own parsers.	Pay per result

---

📖 How to Use

Option 1: Apify Console (Easy Mode)

1. Search Keyword: Enter the product or service you are looking for (e.g., PlayStation 5).
2. Sort By: Choose Newest to get the latest listings, or Cheapest for deals.
3. Max Pages: Limit how many pages to scrape (1 page ≈ 50 ads).
4. Proxy Setup (Crucial):
   • OLX Brazil has strict security.
   • Select "Residential Proxies" (Apify Proxy).
   • Note: Datacenter proxies often fail with 403 errors.
5. Start: Click the Play button and wait for the run to finish.
6. Download: Export your data in Excel, CSV, JSON, or XML format.

Option 2: API (For Developers)

You can integrate this actor into your own applications using the Apify API.

Input Payload (JSON):

{
    "searchQuery": "Chevrolet Onix",
    "sortBy": "newest",
    "maxPages": 2,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

Python Example:

from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')
run_input = {
    "searchQuery": "Apartamento",
    "sortBy": "newest",
    "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"] }
}

run = client.actor("daddyapi/olx-brazil-scraper").call(run_input=run_input)

# Fetch results
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']} - {item['price']['display']}")

---

📊 Data Output Structure

The scraper returns structured JSON for each ad.

{
  "id": "12938475",
  "title": "iPhone 14 Pro Max 256GB Impecável",
  "price": {
    "display": "R$ 6.500",
    "amount": 6500,
    "currency": "BRL"
  },
  "location": {
    "city": "São Paulo",
    "region": "SP"
  },
  "description": "Aparelho sem detalhes, bateria 100%...",
  "photos": [
    "https://img.olx.com.br/images/1.jpg",
    "https://img.olx.com.br/images/2.jpg"
  ],
  "url": "https://sp.olx.com.br/sao-paulo-e-regiao/celulares/iphone-14-12938475",
  "postedAt": 1704050000,
  "isBusiness": false,
  "source": "BR_NEXT"
}

---

🛡️ Proxy Recommendations

OLX Brazil is aggressive against bots.

• Residential Proxies: Highly Recommended.
• Datacenter Proxies: Likely to be blocked.

---

⚖️ Legal & Ethics

This scraper is intended for educational and analytical purposes.

• Respect OLX Brazil's Terms of Service.
• Do not use this tool to spam sellers.
• Use responsible rate limits to avoid overloading the website.