# OLX Brazil API

OLX Brazil (olx.com.br) is a marketplace where individuals and businesses post items for sale. `product_detail` reads one listing page and returns the listing as one object.

Pass a listing page link as `url`; it ends with the listing number, such as `https://sp.olx.com.br/sao-paulo-e-regiao/celulares/iphone-15-128gb-1234567890` (the number in this example only shows the format). The subdomain is the two-letter state code (`sp.`, `rj.`) or `www.`. `id` is the listing number. `category`, `parent_category`, `condition` and `attributes` keep the page's Portuguese text. `price` is a whole number in `currency` (BRL for Brazilian reais); `price`, `currency`, `condition` and `images` are missing when the listing has none. `seller_type` is `private` for an individual and `professional` for a business. Seller phone numbers, postal codes and map coordinates are not included. A removed or missing listing returns an empty result with `empty_reason` `item_not_found` and is not charged.

- Request: POST https://api.everyinfra.com/api/v1/social with `{"platform": "olx", "action": "<action>", "params": {...}}`
- Canonical page: [https://everyinfra.com/en/olx-api](https://everyinfra.com/en/olx-api?utm_medium=ai_doc&utm_campaign=page_md)
- Each capability uses the price recorded in the public catalog. The response includes the amount charged. Authentication failures, invalid parameters, failed calls, and empty results are not charged.

## Actions

### product_detail — Product details
Read one listing on OLX Brazil (olx.com.br) from its listing page link (`url`). The object has title, description, price and currency, category, condition, attributes, image links, posting time, seller name and type, and city, neighborhood and state. Seller phone numbers, postal codes, map coordinates and chat or contact options are not included.
- Sync delivery · Price: $1.19 per 1,000 requests
- Parameters:
  - `url` (required): OLX Brazil listing link, ending in the listing number, such as `https://sp.olx.com.br/sao-paulo-e-regiao/celulares/iphone-15-128gb-1234567890`.
- Returns fields: id, title, url, description, price, currency, category, parent_category, condition, attributes, images, posted_at, seller_name, seller_id, seller_type, city, neighborhood, state, country, platform
- Capability page: [https://everyinfra.com/en/olx-api/product_detail](https://everyinfra.com/en/olx-api/product_detail?utm_medium=ai_doc&utm_campaign=page_md) (Markdown: https://everyinfra.com/en/olx-api/product_detail.md)

## OLX Brazil API questions

### What can I retrieve with the OLX Brazil API?

Set `platform` to `olx`. The current catalog lists product details. These action names identify different OLX Brazil objects or views; they are not interchangeable search modes.

### Which input starts the OLX Brazil `product_detail` request?

OLX Brazil listing link, ending in the listing number, such as `https://sp.olx.com.br/sao-paulo-e-regiao/celulares/iphone-15-128gb-1234567890`. Send it as `url` inside `params`.

### Which fields can OLX Brazil `product_detail` return?

Its declared schema includes `title`, `description`, `price`, and `currency`. A declared field can still be absent from an individual record, and every other action has its own field list.

### Does every OLX Brazil action return immediately?

Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add `"mode": "async"` to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog?platform=olx
- API guide for AI clients: https://everyinfra.com/llms.txt · agents guide: https://everyinfra.com/agents.md
