Piloterr

OLX Search

GET
/v2/olx/search

Search OLX Brazil classifieds by keyword and get title, price, location, seller type, and condition as structured JSON in real time.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

query*string

Search keyword or phrase, as you would type it in the OLX search bar. Supports Portuguese terms for Brazilian inventory.

Example 1:

iphone 14

Example 2:

honda civic 2020

Example 3:

apartamento centro são paulo
category?string

OLX category slug to restrict results to a specific vertical. Common values:

  • eletronicos-e-celulares: Electronics and phones
  • autos-e-pecas: Cars and auto parts
  • imoveis: Real estate
  • eletrodomesticos: Home appliances
  • esportes-e-lazer: Sports and leisure

Example:

autos-e-pecas
state?string

Brazilian state abbreviation to filter results geographically.

Example:

SP
city?string

City slug to narrow results to a specific municipality. Use lowercase with hyphens.

Example:

sao-paulo
min_price?number

Minimum listing price in BRL.

Example:

500
max_price?number

Maximum listing price in BRL.

Example:

5000
seller_type?string

Filter by seller type.

  • particular: Private individual sellers
  • profissional: Professional/business sellers

Leave empty to return both.

sort?string

Sort order for results.

  • relevance: Most relevant first (default)
  • date: Most recent listings first
  • price_asc: Lowest price first
  • price_desc: Highest price first
Default"relevance"
page?number

Page number for paginated results. Default: 1.

Example:

2
Default"1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/olx/search?query=string"
{  "page": 1,  "results": [    {      "id": "902901124",      "url": "https://www.olx.com.br/eletronicos-e-celulares/celulares-e-smartphones/iphone-14-128gb-como-novo-IDJ4mBb.html",      "price": 3200,      "title": "iPhone 14 128GB Como Novo",      "images": [        "https://img.olx.com.br/images/902901124_1.jpg",        "https://img.olx.com.br/images/902901124_2.jpg"      ],      "category": "Celulares e Smartphones",      "featured": false,      "location": {        "city": "São Paulo",        "state": "SP"      },      "condition": "usado",      "thumbnail": "https://img.olx.com.br/images/902901124_1_thumb.jpg",      "category_id": "3486",      "seller_type": "particular",      "installments": {        "amount": 1066.67,        "quantity": 3      },      "published_at": "2026-04-29T14:35:00.000Z",      "free_shipping": false,      "original_price": 3800    },    {      "id": "893412874",      "url": "https://www.olx.com.br/iphone-14-pro-256gb-roxo-lacrado-IDJ2kPr.html",      "price": 4900,      "title": "iPhone 14 Pro 256GB Roxo Lacrado",      "images": [        "https://img.olx.com.br/images/893412874_1.jpg",        "https://img.olx.com.br/images/893412874_2.jpg"      ],      "category": "Celulares e Smartphones",      "featured": true,      "location": {        "city": "Rio de Janeiro",        "state": "RJ"      },      "condition": "novo",      "thumbnail": "https://img.olx.com.br/images/893412874_1_thumb.jpg",      "category_id": "3486",      "seller_type": "profissional",      "installments": {        "amount": 490,        "quantity": 10      },      "published_at": "2026-04-29T10:12:00.000Z",      "free_shipping": true,      "original_price": null    }  ],  "total_results": 8432,  "results_per_page": 25}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}