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.

One API key is all you need, with no OLX Brazil account or cookie. It also works as an MCP tool in Claude and Cursor, and you can claim $1 in trial credit to try it first.

Send POST https://api.everyinfra.com/api/v1/social with platform set to olx and action set to a capability name from the list below, for example product_detail.

  • 1 capability
  • $1.19 per 1,000 requests
  • No charge for failed calls or empty results

Platform availability

24h health
Normal
Normal

Last 30 days

Available capabilities

Each OLX Brazil action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.

CapabilityWhat it doesPer 1,00024-hour health · All normal
Product detailsproduct_detailRead one listing on OLX Brazil (olx.com.br) from its listing page link (url).$1.19 per 1,000 requestsNormal

5 questions to ask before choosing a data API for OLX Brazil

Do I need to log in to OLX Brazil or provide a cookie to make calls?

No. Send Authorization: Bearer with your API key in the request header, and put platform, action and the capability parameters in the request body. There is no QR-code login, no login state to maintain and no browser to run.

How is it billed? Are failed requests charged? Is there a free trial?

Billing is per request, $1.19 per 1,000 requests. Failed requests, empty results, invalid parameters and authentication failures are not charged. Star both everyinfra/everyinfra-agent-plugins and everyinfra/seo-skills on GitHub, then claim $1 under Balance & top-ups in the console. It is valid for 24 hours after you claim it, and no credit card is needed.

Can I connect this OLX Brazil API to Claude or Cursor?

Yes. The remote MCP URL is https://api.everyinfra.com/mcp. Add Authorization: Bearer and your API key as a request header; there is no local program to install. Setup for Claude, Cursor, ChatGPT and Claude Code is on https://everyinfra.com/en/mcp-server.

What compliance points apply when using OLX Brazil data?

The EveryInfra Terms of Service require you to make sure your use of the data complies with applicable law and the platform's terms. They prohibit unlawful use, violating privacy or intellectual property, and bulk scraping for harassment, fraud or other malicious purposes. If you use personal information such as nicknames and avatars, keep only the fields your business needs.

What OLX Brazil data can I get?

Available OLX Brazil capabilities (1): Product details. The parameters and response fields of each capability are in the API reference on this page.

What does each OLX Brazil action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and features of the official site are not part of the EveryInfra API unless this page lists them.

Sync delivery for every action.

ActionRequiredOptionalLimitPer 1,000Response fields
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.

url——$1.19 per 1,000 requestsid · title · url · description · price · currency · category · parent_category · condition · attributes · images · posted_at · seller_name · seller_id · seller_type · city · neighborhood · state · country · platform

What do the OLX Brazil product_detail parameters mean?

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.

Full API reference: parameters, code samples, response example and health
urlRequired
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.
OLX Help Center: Como publicar anúncio — OLX's help article on posting a listing says the seller enters a title (up to 90 characters), adds photos, picks a category and subcategory and fills in extra details, enters the CEP (postal code) to set the area, and enters the total price; the description can be up to 6,000 characters. The source supports the listing fields the API returns: title, description, category, price, images and area; this API's parameters are defined by EveryInfra, and the source does not vouch for results. · Checked

How to use the OLX Brazil API

  1. 01Choose a platform action from the public catalog.
  2. 02Send the platform, action, and required parameters to POST /api/v1/social.
  3. 03Read the result from the response. For an asynchronous action, poll the returned job ID.
  4. 04Store the response fields that your application needs.
olx_product_detail.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"olx","action":"product_detail","params":{"url":"<url>"}}'

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.

Google Analytics needs consent. Privacy