# OLX Brazil Search API Documentation

<p><strong>OLX Brazil Search API</strong> searches public olx.com.br ads across all categories by query with page pagination. Category, location, price and sort are not upstream filters and return a non-billable 422; each row publishes the category OLX itself assigns. Each row carries id, title, numeric BRL price parsed from the locale string, original price, location, ISO 8601 date from Unix seconds, full-size image, seller type and category. A valid empty result is billed; every failure is not.</p>

- **Documentation:** [https://scrappa.co/docs/olx-br-api/olx_br_search](https://scrappa.co/docs/olx-br-api/olx_br_search)
- **API group:** OLX Brazil API
- **Endpoint:** `GET https://scrappa.co/api/olx-br/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Search words across all categories. Example: carro. |
| `page` | integer | No | 1-based page, 1 to 100. |

## Example response

```json
{
    "data": {
        "page": 1,
        "total": 58931,
        "results": [
            {
                "id": "1400000000",
                "url": "https://www.olx.com.br/carro-exemplo-1400000000",
                "image": "https://img.olx.com.br/images/abc/original.jpg",
                "price": {
                    "value": 947950,
                    "currency": "BRL"
                },
                "title": "Carro em bom estado",
                "category": "Carros, vans e utilit\u00e1rios",
                "location": "Fortaleza, Parquel\u00e2ndia",
                "old_price": {
                    "value": 990000,
                    "currency": "BRL"
                },
                "attributes": [
                    {
                        "name": "Marca",
                        "value": "Fiat"
                    }
                ],
                "created_at": "2026-11-19T15:38:50Z",
                "seller_type": "private"
            }
        ],
        "next_page": 2,
        "total_of_ads": 58931,
        "applied_filters": {
            "query": "carro"
        },
        "applied_sorting": null
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. No upstream call and no charge. |
| 500 | Parser Drift | OLX answered with a response shape this parser does not recognise. Never charged. |
| 503 | Upstream Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
