Piloterr

OLX Search

GET
/v2/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

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

Keyword or OLX search URL.

Example 1:

playstation 2

Example 2:

https://www.olx.com.br/brasil?q=playstation+2
region?string

Country 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:

br
page?number

Page number from 1. Page 2 does not repeat page 1 listing ids.

Example:

2
Range1 <= value
benefit?string

OLX Brazil only. Keep listings with one OLX Guarantee benefit. One value at a time.

  • delivery: Entrega Fácil
  • online_payment: pay online through OLX
  • free_shipping: Frete grátis
  • installments: up to 10x without interest

Example:

delivery
sort?string

Order 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:

newest
min_price?number

Lowest price in the local currency. OLX Brazil filters whole reais, so decimals round down.

Example:

130
max_price?number

Highest price in the local currency. OLX Brazil filters whole reais, so decimals round up. Must not be below min_price.

Example:

280
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
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/olx/search?query=string'
Example Response
{  "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  }}