# OLX Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/olx/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/olx-search |

## Description

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

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/olx/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search for 'iphone 14'

```json
{
  "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
}
```

## Documentation

## Overview

OLX is Brazil's largest classifieds marketplace, covering electronics, vehicles, real estate, and dozens of other categories across tens of millions of active listings. The platform blocks automated access with Cloudflare. Piloterr routes each request through infrastructure that handles the bypass, returning paginated search results as structured JSON from a single GET call. No proxy setup, no CAPTCHA handling, no HTML parsing.

Each result includes the listing title, price in BRL, seller type, item condition, city and state, publication date, and image URLs.

## Quickstart

```
GET https://api.piloterr.com/v2/olx/search?query=iphone+14
```

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search keyword or phrase |
| `category` | string | no | OLX category slug |
| `state` | string | no | State abbreviation |
| `city` | string | no | City slug |
| `min_price` | number | no | Minimum price in BRL |
| `max_price` | number | no | Maximum price in BRL |
| `seller_type` | string | no | `particular` or `profissional` |
| `sort` | string | no | Sort order |
| `page` | integer | no | Page number |

## Response fields

| Field | Type | Description |
|---|---|---|
| `results[].title` | string | Listing title |
| `results[].price` | number | Price in BRL |
| `results[].seller_type` | string | Seller type |
| `results[].condition` | string | Item condition |
| `results[].location.city` | string | City |
| `results[].published_at` | string | Publication date |

## Main use cases

- Track real-time price shifts for used electronics on OLX Brazil to calibrate pricing strategies
- Monitor new vehicle listings by state to spot arbitrage opportunities in the used car market
- Build a real estate intelligence feed aggregating OLX ads by city for a property analytics dashboard
- Detect seller volume and pricing patterns by filtering profissional accounts over time
- Power consumer price alert systems with live OLX classified data across Brazil