Piloterr

OLX Ad

GET
/v2/olx/ad

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

Autorização

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parâmetros de consulta

query*string

OLX listing URL.

Example 1:

https://sp.olx.com.br/grande-campinas/games/consoles-de-video-game/playstation-2-fat-destrav-lindo-leitor-novo-1553134354

Example 2:

https://www.olx.pl/d/oferta/apple-iphone-17-pro-256-gb-nowy-szczecin-zaplombowany-karta-sim-ul-baluki-4-szczecin-CID99-ID18Acsd.html
region?string

Ignored when query is a full URL. The host selects the country, for example br for olx.com.br.

Example:

br
return_page_source?boolean

When true, return raw HTML.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corpo da resposta

Successful response

application/json
  1. response
id?integer
url?string
image?string
price?integer
title?string
images?array<string>
region?string
status?unknown
currency?string
latitude?unknown
location?
condition?string
longitude?unknown
old_price?integer
seller_id?integer
created_at?string
negotiable?unknown
parameters?array<>
breadcrumbs?array<>
description?string
is_business?boolean
is_promoted?boolean
seller_name?string
refreshed_at?string
free_shipping?boolean
price_display?string
delivery_enabled?boolean
online_payment_enabled?boolean
Example Request
curl -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}