OLX Search
Search OLX by keyword in Brazil or seven other countries. Set region=br for OLX Brazil in reais, sort by newest, filter by price, Entrega Fácil or online payment. Region defaults to Poland.
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringKeyword or OLX search URL.
Example 1:
playstation 2Example 2:
https://www.olx.com.br/brasil?q=playstation+2region?stringCountry code. Default pl. Ignored when query is a full URL.
br: OLX Brazil (BRL)pl: Poland (PLN)ro: Romania (RON)pt: Portugal (EUR)bg: Bulgaria (EUR)ua: Ukraine (UAH)kz: Kazakhstan (KZT)uz: Uzbekistan (UZS)
Example:
brpage?numberPage number from 1. Page 2 does not repeat page 1 listing ids.
Example:
21 <= valuebenefit?stringOLX Brazil only. Keep listings with one OLX Guarantee benefit. One value at a time.
delivery: Entrega Fácilonline_payment: pay online through OLXfree_shipping: Frete grátisinstallments: up to 10x without interest
Example:
deliverysort?stringOrder of the results. newest puts the latest listings first. Empty keeps the OLX relevance order.
On OLX Brazil the order follows the publication date, and OLX also matches the keyword in descriptions. Elsewhere OLX orders by last refresh and keeps promoted listings on top.
Example:
newestmin_price?numberLowest price in the local currency. OLX Brazil filters whole reais, so decimals round down.
Example:
130max_price?numberHighest price in the local currency. OLX Brazil filters whole reais, so decimals round up. Must not be below min_price.
Example:
280return_page_source?booleanWhen true, return raw HTML.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/olx/search?query=string'{ "results": [ { "id": 1553134354, "url": "https://sp.olx.com.br/grande-campinas/games/consoles-de-video-game/playstation-2-fat-destrav-lindo-leitor-novo-1553134354", "image": "https://img.olx.com.br/images/31/310688228456706.jpg", "price": 990, "title": "PlayStation 2 Fat destrav lindo, leitor NOVO", "region": "br", "currency": "BRL", "location": { "city": "Indaiatuba", "region": "SP", "district": "Jardim Morada do Sol" }, "condition": "Usado - Excelente", "old_price": 1090, "created_at": "2026-11-15T16:27:49+00:00", "negotiable": null, "is_business": false, "is_promoted": false, "free_shipping": true, "price_display": "R$ 990", "delivery_enabled": true, "online_payment_enabled": true } ], "pagination": { "next": "https://www.olx.com.br/brasil?q=PlayStation+2&o=2", "page": 1, "per_page": 50, "total_pages": 100, "total_results": 5902 }}