Playground Sign in Start free
Marketplaces and classifieds · olx.com.br

How to scrape OLX Brazil

OLX Brazil is a marketplace and classifieds site where you can find listings across various categories. Developers typically collect product information, pricing data, and listing details from its public pages.

Ujeebu scrapes any public website. Not listed here? Try any URL in the Playground or ask us about a site.

Mostly working 5 credits a page, about $0.50 per 1,000 on Pro

14 of 23 of our checks passed in the last 7 days (60.9%).

Last check 2026-11-03 18:06 UTC · last pass 2026-11-01 05:34 UTC · checked with our own requests, never customer data.

Try it in the Playground

Recipe one call

Use the OLX Brazil recipe: send the URL, get JSON

5 credits (JS) a page
curl -G 'https://api.ujeebu.com/scrape' \
  -H "ApiKey: $UJEEBU_API_KEY" \
  --data-urlencode 'url=https://www.olx.com.br/brasil?q=iphone' \
  --data-urlencode 'recipe=olx-br/listing'

The answer is {"result": {...}} with the fields of the recipe. Billed like any /scrape call: successful responses cost credits; blocked, timed-out and failed requests are free.

Run the code on this page with your own key: 5,000 free credits for 7 days, no card. Get a free API key →

Recipes

Call a recipe by name with the recipe parameter: the Scrape API applies its extract rules and the settings that work on OLX Brazil. Each recipe was run on two real OLX Brazil pages and keeps only the fields that came back on both; it is checked again every week, and hidden if it stops working.

Search and listing pages

Validated 2026-10-26

One call: recipe=olx-br/listing 5 credits (JS) a page

curl -G 'https://api.ujeebu.com/scrape' \
  -H "ApiKey: $UJEEBU_API_KEY" \
  --data-urlencode 'url=https://www.olx.com.br/brasil?q=iphone' \
  --data-urlencode 'recipe=olx-br/listing'

The answer is {"result": {...}} with the fields below; the Ujb-Recipe header names the version (for example olx-br/listing@v1) and Ujb-Credits the cost.

What this recipe extracts

FieldTypeExample
adslist of 3+ items
ads[].urlURLhttps://sp.olx.com.br/baixada-santista-e-litoral-sul/celulares/ipho...
ads[].titletextIPHONE 15 PRO MAX 256GB - BLACK TITANIUM
ads[].imageimage URLhttps://img.olx.com.br/thumbs700x500/56/562644320622000.webp
ads[].pricetextR$ 3.990
ads[].locationtextSantos, Santa Maria
ads[].postedtextHoje, 11:14

Examples from www.olx.com.br/brasil on 2026-10-26, shortened.

Sample output (real, trimmed)

{
    "ads": [
        {
            "url": "https://sp.olx.com.br/baixada-santista-e-litoral-sul/celulares/iphone-15-pro-max-256gb-black-titanium-1536238470",
            "title": "IPHONE 15 PRO MAX 256GB - BLACK TITANIUM",
            "image": "https://img.olx.com.br/thumbs700x500/56/562644320622000.webp",
            "price": "R$ 3.990",
            "location": "Santos, Santa Maria",
            "posted": "Hoje, 11:14"
        },
        {
            "url": "https://sp.olx.com.br/sao-paulo-e-regiao/celulares/iphone-15-pro-max-256-gb-titanio-azul-1544594589",
            "title": "iPhone 15 Pro Max 256 GB Titânio Azul",
            "image": "https://img.olx.com.br/thumbs700x500/14/147631693010882.webp",
            "price": "R$ 4.690",
            "location": "São Paulo, Vila Andrade",
            "posted": "Ontem, 21:03"
        },
        {
            "url": "https://ba.olx.com.br/grande-salvador/celulares/iphone-12-usado-128gb-branco-1532163625",
            "title": "Iphone 12 usado 128gb branco",
            "image": "https://img.olx.com.br/thumbs700x500/93/935623689909610.webp",
            "price": "R$ 1.500",
            "location": "Salvador, Garcia",
            "posted": "Ontem, 11:44"
        }
    ]
}
extract_rules (1 rule): the rules behind the recipe

The API applies these rules and the settings js=true for you when you send recipe=olx-br/listing. To change what comes back, send your own extract_rules (they replace the recipe's) or any setting (yours always win). Sites without a recipe work the same way with extract rules.

{
    "ads": {
        "selector": "section.olx-adcard__horizontal",
        "type": "obj",
        "multiple": true,
        "children": {
            "url": {
                "selector": "a[data-testid=\"adcard-link\"]",
                "type": "link"
            },
            "title": {
                "selector": ".olx-adcard__title",
                "type": "text"
            },
            "image": {
                "selector": ".olx-adcard__media img",
                "type": "image"
            },
            "price": {
                "selector": ".olx-adcard__price",
                "type": "text"
            },
            "location": {
                "selector": ".olx-adcard__location",
                "type": "text"
            },
            "posted": {
                "selector": ".olx-adcard__date",
                "type": "text"
            }
        }
    }
}

Ad pages

Validated 2026-11-03

One call: recipe=olx-br/detail 5 credits (JS) a page

curl -G 'https://api.ujeebu.com/scrape' \
  -H "ApiKey: $UJEEBU_API_KEY" \
  --data-urlencode 'url=https://sp.olx.com.br/sao-paulo-e-regiao/ciclismo/bike-caixinha-galp-ryde-1513992546' \
  --data-urlencode 'recipe=olx-br/detail'

The answer is {"result": {...}} with the fields below; the Ujb-Recipe header names the version (for example olx-br/detail@v1) and Ujb-Credits the cost.

What this recipe extracts

FieldTypeExample
product.currencytextBRL
product.nametextBike caixinha galp ryde
product.urlURLhttps://sp.olx.com.br/sao-paulo-e-regiao/ciclismo/bike-caixinha-gal...
imageimage URLhttps://img.olx.com.br/images/62/620632414158836.jpg

Examples from sp.olx.com.br/sao-paulo-e-regiao/ciclismo/bike-caixinha-ga... on 2026-11-03, shortened.

Sample output (real, trimmed)

{
    "product": {
        "currency": "BRL",
        "name": "Bike caixinha galp ryde",
        "url": "https://sp.olx.com.br/sao-paulo-e-regiao/ciclismo/bike-caixinha-galp-ryde-1513992546"
    },
    "image": "https://img.olx.com.br/images/62/620632414158836.jpg"
}
extract_rules (2 rules): the rules behind the recipe

The API applies these rules and the settings js=true for you when you send recipe=olx-br/detail. To change what comes back, send your own extract_rules (they replace the recipe's) or any setting (yours always win). Sites without a recipe work the same way with extract rules.

{
    "product": {
        "type": "fn",
        "fn": "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), name: all(g('name')), url: one(g('url|offers.url')) };"
    },
    "image": {
        "selector": "meta[property=\"og:image\"]",
        "type": "attr",
        "attribute": "content"
    }
}

Code

Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one calls the recipe by name (the Go SDK has no recipe field, so the Go script sends the recipe's rules and settings itself), prints the extracted JSON, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.

Search and listing pages

Pages through 3 result pages, one at a time, and stops early when a page has no results.

olx_br_listing_sdk.py pip install ujeebu-python==0.1.5
# Scrape OLX Brazil search and listing pages with the Ujeebu Scrape API.
# Calls the recipe olx-br/listing: the API applies its extract rules and validated settings (validated 2026-10-26). Send extract_rules or any setting to override them.
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 olx_br_listing_sdk.py

import json
import os
import sys
import time
from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
START_URL = "https://www.olx.com.br/brasil?q=iphone"
PAGES = 3
RECIPE = "olx-br/listing"  # rules and settings come from the recipe; add your own to override them


def page_url(page):
    if page == 1:
        return START_URL
    parts = urlsplit(START_URL)
    query = dict(parse_qsl(parts.query))
    query["o"] = str(page)
    return urlunsplit(parts._replace(query=urlencode(query)))


def scrape(client, url):
    # a GET with recipe=: the API applies the recipe and answers {"result": {...}}
    try:
        response = client.scrape(url, params={"recipe": RECIPE})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}, Ujb-Recipe: {response.headers.get('Ujb-Recipe')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for page in range(1, PAGES + 1):
    result = scrape(client, page_url(page))
    print(json.dumps(result, indent=2, ensure_ascii=False))
    if not result.get("ads"):
        break
    time.sleep(2)  # be polite: one page at a time

Ad pages

Runs the recipe on the two pages it was validated on, one after the other.

olx_br_detail_sdk.py pip install ujeebu-python==0.1.5
# Scrape OLX Brazil ad pages with the Ujeebu Scrape API.
# Calls the recipe olx-br/detail: the API applies its extract rules and validated settings (validated 2026-11-03). Send extract_rules or any setting to override them.
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 olx_br_detail_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://sp.olx.com.br/sao-paulo-e-regiao/ciclismo/bike-caixinha-galp-ryde-1513992546",
    "https://mg.olx.com.br/belo-horizonte-e-regiao/ciclismo/bicicleta-1526437702",
]
RECIPE = "olx-br/detail"  # rules and settings come from the recipe; add your own to override them


def scrape(client, url):
    # a GET with recipe=: the API applies the recipe and answers {"result": {...}}
    try:
        response = client.scrape(url, params={"recipe": RECIPE})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}, Ujb-Recipe: {response.headers.get('Ujb-Recipe')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    print(json.dumps(scrape(client, url), indent=2, ensure_ascii=False))

SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/olx-br.json.

Try it yourself

Run this on OLX Brazil with your own key

Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card.

URL patterns and pagination

What the URLs look like, read from the pages our checks fetched.

Search and listing pages

Search or listing URL
https://www.olx.com.br/brasil?q={query}
Next pages
add o=2, o=3 and so on. Page 2: https://www.olx.com.br/brasil?q=iphone&o=2
Validated on
https://www.olx.com.br/brasil?q=iphonehttps://www.olx.com.br/brasil?q=geladeira

Ad pages

Validated on
https://sp.olx.com.br/sao-paulo-e-regiao/ciclismo/bike-caixinha-galp-ryde-1513992546https://mg.olx.com.br/belo-horizonte-e-regiao/ciclismo/bicicleta-1526437702

Settings that work today

From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.

Endpoint/scrape
jstrue
Costup to 5 credits a request

For search and listing pages, change the query or the page parameter in the URL to paginate, and fetch the pages one after another rather than in bursts. Collect detail page URLs from listing pages first, then fetch each detail page. Our checks run with JavaScript rendering on (js=true): keep it on. Start with the default (rotating) proxy, the cheapest one that passed most of its attempts in our checks.

Try it in the Playground
Proxies we tried on OLX Brazil (1), attempts and passes over 7 days
ProxyAttemptsPassed
Default (rotating)2314

Highlighted: the cheapest proxy that passes most of our checks of this site.

Troubleshooting

The failures our own checks of olx.com.br ran into over the last 7 days, and what got the page in the same check.

What happenedTimesWhat fixed it
The site blocked the request (HTTP 403 or a block page) 9 None of the settings we tried got past it in 7 days.

What people build with OLX Brazil data

  • Price researchSee what similar items sell for, by condition and location.More on this use case
  • New ads alertsCatch new ads for the searches you care about shortly after they appear.

Limits and etiquette

  • Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
  • Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
  • Read OLX Brazil's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.

Questions

Can you scrape OLX Brazil with Ujeebu?

Partly. 14 of 23 checks of public OLX Brazil pages passed in the last 7 days; most failures were the site blocked the request (HTTP 403 or a block page). Retry failed pages later, and use the settings on this page.

Which settings work for OLX Brazil?

Call /scrape with js=true. On the default (rotating) proxy, 14 of 23 attempts passed in the last 7 days.

How many credits does a OLX Brazil request cost?

With these settings a request costs up to 5 credits. Only responses with HTTP 200 or 404 are billed: a blocked or timed-out request is free.

Which fields can I extract from OLX Brazil?

With the extraction recipes on this page, validated on real OLX Brazil pages through our API: search and listing pages: url, title, image, price, location, posted; ad pages: currency, name, url, image. Pass the recipe as extract_rules in a POST to /scrape and the API returns those fields as JSON.

How fresh is this page?

The status and settings come from our own health checks of olx.com.br, which run around the clock. Last check: 2026-11-03 18:06:46 UTC; last pass: 2026-11-01 05:34:34 UTC.