OLX Ad
GET
Read one OLX ad from its URL, including OLX Brazil. You get the price, the location, the seller, the attributes, and the Entrega Fácil and online payment flags.
Credit cost: 1 credit per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringOLX listing URL.
Example 1:
https://sp.olx.com.br/grande-campinas/games/consoles-de-video-game/playstation-2-fat-destrav-lindo-leitor-novo-1553134354Example 2:
https://www.olx.pl/d/oferta/apple-iphone-17-pro-256-gb-nowy-szczecin-zaplombowany-karta-sim-ul-baluki-4-szczecin-CID99-ID18Acsd.htmlregion?stringIgnored when query is a full URL. The host selects the country, for example br for olx.com.br.
Example:
brreturn_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}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
id?integerurl?stringimage?stringprice?integertitle?stringimages?array<string>region?stringstatus?unknowncurrency?stringlatitude?unknownlocation?condition?stringlongitude?unknownold_price?integerseller_id?integercreated_at?stringnegotiable?unknownparameters?array<>breadcrumbs?array<>description?stringis_business?booleanis_promoted?booleanseller_name?stringrefreshed_at?stringfree_shipping?booleanprice_display?stringdelivery_enabled?booleanonline_payment_enabled?booleancurl -X GET 'https://api.piloterr.com/v2/olx/ad?query=string'Example Response
{ "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", "images": [ "https://img.olx.com.br/images/31/310688228456706.jpg" ], "region": "br", "status": null, "currency": "BRL", "latitude": null, "location": { "city": "Indaiatuba", "region": "SP", "district": "Jardim Morada do Sol" }, "condition": "Usado - Excelente", "longitude": null, "old_price": 1090, "seller_id": 9807743, "created_at": "2026-11-15T16:27:49+00:00", "negotiable": null, "parameters": [ { "name": "Marca do Console", "value": "Sony" }, { "name": "Modelo", "value": "Playstation 2" }, { "name": "Condição", "value": "Usado - Excelente" } ], "breadcrumbs": [ { "url": "https://www.olx.com.br/estado-sp", "name": "São Paulo" }, { "url": "https://www.olx.com.br/estado-sp/grande-campinas", "name": "Grande Campinas" } ], "description": "Aparelho sem riscos, gaveta abre na primeira, leitor novo.", "is_business": false, "is_promoted": false, "seller_name": "beto", "refreshed_at": "2026-11-15T16:27:49+00:00", "free_shipping": true, "price_display": "R$ 990", "delivery_enabled": true, "online_payment_enabled": true}