Recipe Marketplaces and classifieds

OLX Brazil scraper API: search results and ad pages as JSON

Send any OLX Brazil page URL with recipe=olx-br and get title, price, location and 5 more fields as JSON. No selectors to write, no proxies to pick.

2 page types
8 fields
5 credits a page · $0.50 per 1,000
Mostly working · 60.9% in 7 days

Get a free API key Try it in the Playground

5,000 free credits for 7 days, no card.

recipe=olx-br/listing

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'

200 OK · JSON

{
    "result": {
        "title": "IPHONE 15 PRO MAX 256GB - BLACK TITANIUM",
        "price": "R$ 3.990",
        "location": "Santos, Santa Maria",
        "posted": "Hoje, 11:14"
    },
    "success": true
}

What you get from OLX Brazil

The fields of each page type and a real sample from our last validation, shortened.

Search and listing pages `recipe=olx-br/listing` 5 credits a page

Field	Type	Example
`ads`	list of 3+ items
`ads[].url`	URL	https://sp.olx.com.br/baixada-santista-e-litoral-sul/celulares/ipho...
`ads[].title`	text	IPHONE 15 PRO MAX 256GB - BLACK TITANIUM
`ads[].image`	image URL	https://img.olx.com.br/thumbs700x500/56/562644320622000.webp
`ads[].price`	text	R$ 3.990
`ads[].location`	text	Santos, Santa Maria
`ads[].posted`	text	Hoje, 11:14

Sample answer, validated 2026-10-26

{
    "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"
        }
    ]
}

Ad pages `recipe=olx-br/detail` 5 credits a page

Field	Type	Example
`product.currency`	text	BRL
`product.name`	text	Bike caixinha galp ryde
`product.url`	URL	https://sp.olx.com.br/sao-paulo-e-regiao/ciclismo/bike-caixinha-gal...
`image`	image URL	https://img.olx.com.br/images/62/620632414158836.jpg

Sample answer, validated 2026-11-03

{
    "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"
}

One call

Send the page URL and the recipe name to the Scrape API. The recipe brings the extract rules and the settings that work on OLX Brazil (JavaScript rendering).

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'

import os, requests

r = requests.get(
    "https://api.ujeebu.com/scrape",
    params={"url": "https://www.olx.com.br/brasil?q=iphone", "recipe": "olx-br/listing"},
    headers={"ApiKey": os.environ["UJEEBU_API_KEY"]},
    timeout=120,
)
print(r.json()["result"])

const params = new URLSearchParams({
  url: "https://www.olx.com.br/brasil?q=iphone",
  recipe: "olx-br/listing",
});
const res = await fetch(`https://api.ujeebu.com/scrape?${params}`, {
  headers: { ApiKey: process.env.UJEEBU_API_KEY },
});
console.log((await res.json()).result);

The answer is {"result": {...}} with the headers Ujb-Recipe and Ujb-Credits. Other page types: recipe=olx-br/detail, or recipe=olx-br and the API picks the page type from the URL. Your own parameters always win over the recipe.

What people build with OLX Brazil data

Price research
See what similar items sell for, by condition and location.
Learn more
New ads alerts
Catch new ads for the searches you care about shortly after they appear.

Price

Same price as the page call, no fee for the recipe. Only successful responses are billed; blocked, timed-out and failed requests are free.

Page type	Credits a page	Per 1,000, Starter	Per 1,000, Pro
Search results, Ad page	5	$0.82	$0.50

See all plans

FAQ

What does the OLX Brazil recipe return?

JSON with 8 fields from search results (recipe=olx-br/listing) and ad page (recipe=olx-br/detail), for example title, price, location, url, image. The answer is {"result": {...}} with the fields shown on this page.

How much does it cost to scrape OLX Brazil?

5 credits a page ($0.50 per 1,000 on Pro, $0.82 on Starter). Same price as the page call, no fee for the recipe. Only successful responses are billed; blocked, timed-out and failed requests are free.

Do I need proxies or a headless browser?

No. The recipe brings the settings that work on OLX Brazil: JavaScript rendering. Send only the URL and recipe=olx-br/listing.

What happens when OLX Brazil changes its pages?

We check OLX Brazil every day and re-validate the recipe on real pages every week, then fix it when the site changes. Until a fix is live, the API answers 404 "the recipe has no working version" instead of empty data, and that call is free.

Can I change the fields?

Yes. Send your own extract_rules or any setting (js, proxy_type, wait_for) and it wins over the recipe. The developer guide shows the recipe rules to start from.

Developer guide: settings, pagination, troubleshootingHow to scrape OLX Brazil: live status, URL patterns, the recipe rules and runnable code.

Related recipes

All recipes

Logos and names belong to their owners. Ujeebu is not affiliated with OLX Brazil.

Get OLX Brazil data as JSON today.

5,000 free credits for 7 days. No card.