# OLX Product

## Overview

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

## Description

Fetch a single OLX Brazil listing by URL and get full details: title, price, description, seller profile, images, and category attributes as structured JSON.

## 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/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Fetch listing by URL

```json
{
  "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",
  "views": 847,
  "images": [
    "https://img.olx.com.br/images/902901124_1.jpg",
    "https://img.olx.com.br/images/902901124_2.jpg",
    "https://img.olx.com.br/images/902901124_3.jpg"
  ],
  "seller": {
    "id": "48273910",
    "name": "Carlos M.",
    "type": "particular",
    "total_ads": 4,
    "profile_url": "https://www.olx.com.br/perfil/48273910",
    "member_since": "2021-03-15T00:00:00.000Z"
  },
  "status": "active",
  "payment": {
    "installments": {
      "amount": 1066.67,
      "quantity": 3
    },
    "free_shipping": false,
    "online_payment": true
  },
  "category": "Celulares e Smartphones",
  "location": {
    "lat": -23.5629,
    "lng": -46.6861,
    "city": "São Paulo",
    "state": "SP",
    "neighborhood": "Pinheiros"
  },
  "condition": "usado",
  "thumbnail": "https://img.olx.com.br/images/902901124_1_thumb.jpg",
  "attributes": [
    {
      "label": "Marca",
      "value": "Apple"
    },
    {
      "label": "Modelo",
      "value": "iPhone 14"
    },
    {
      "label": "Memória interna",
      "value": "128 GB"
    },
    {
      "label": "Cor",
      "value": "Preto"
    }
  ],
  "updated_at": "2026-04-30T09:10:00.000Z",
  "category_id": "3486",
  "description": "Vendo iPhone 14 128GB na cor preta, em ótimo estado de conservação. Sem arranhões, bateria com 89% de saúde. Acompanha caixa original, carregador e capinha. Aceito cartão no débito ou PIX. Não faço troca.",
  "published_at": "2026-04-29T14:35:00.000Z",
  "original_price": 3800
}
```

## Documentation

## Overview

OLX Brazil blocks automated requests with Cloudflare, making direct programmatic access to listing pages unreliable without managing proxies and fingerprinting. Piloterr absorbs that infrastructure layer: send a listing URL and receive the full classified ad as structured JSON in real time.

The response covers the full seller description, asking price, condition, seller profile, location with coordinates, category-specific attributes, and all images.

## Quickstart

```
GET https://api.piloterr.com/v2/olx/product?url=https://www.olx.com.br/eletronicos-e-celulares/iphone-14-128gb-IDJ4mBb.html
```

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `url` | string | yes | Full URL of the OLX listing page |

## Main use cases

- Enrich lead databases by fetching full OLX listing details for each ad ID in a prospect list
- Build sold-price datasets by recording the price before listing status changes to `sold`
- Collect vehicle attributes (brand, model, year, mileage) from OLX car ads to train pricing models
- Monitor specific listings to detect price drops or status transitions from `active` to `sold`
- Identify high-volume professional resellers by extracting seller profiles and total ad counts