OLX API

OLX classified listings, categories and seller profiles from many countries as JSON.

The API.SH OLX API turns public OLX pages into structured JSON for Poland, Ukraine, Romania, Bulgaria, Portugal, Kazakhstan, Uzbekistan and India. Search listings with sort, price range, category, region or city, condition, seller type, photos and delivery filters. Read one listing with its full description, price, attributes, location and seller summary, browse category pages, and pull a seller's profile with their active listings.

Get a free API key Try it in the playground

4 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

OLX listing search

GET https://api.api.sh/olx/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the OLX API

Price tracking for used goods

Search a category such as cars or phones with price and condition filters and follow price changes, including a listing's previous price.

/search /item

Deal alerts

Sort by newest with a price ceiling and send new matches to a Sheet, Slack or your own app.

/search

Market and category research

Browse category pages with listing counts and subcategories to see what sells in a country, region or city.

/category /search

Seller and business monitoring

Read a seller's profile, member since date, response time and active listings to follow businesses and dealers.

/seller

Car and property attribute analysis

Filter by category attributes such as year or fuel and read each listing's attributes, location and photos.

/search /item

OLX data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

OLX API endpoints and prices

Every OLX endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

OLX listing search

/olx/v1/search

$1 · $2 PAYG

1 credit

Profiles and accounts1

OLX seller profile and listings

/olx/v1/seller

$1 · $2 PAYG

1 credit

Products, listings and places2

OLX category listings /olx/v1/category	$1 · $2 PAYG 1 credit
OLX listing /olx/v1/item	$1 · $2 PAYG 1 credit

Call the OLX API

OLX listing search: GET https://api.api.sh/olx/v1/search

curl "https://api.api.sh/olx/v1/search?q=iphone" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/olx/v1/search",
    params={"q": "iphone"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/olx/v1/search");
url.searchParams.set("q", "iphone");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/olx/v1/search", "q", "iphone")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "OLX" and "OLX listing search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for OLX data

Public data only: no OLX login, cookies or account needed
One key and one response shape for OLX and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official OLX API

OLX runs developer portals and partner APIs in several countries, which let approved advertisers post and manage their own ads using OAuth credentials. API.SH is for reading public listings, so it needs no OLX developer account or partner approval and returns search, item, category and seller data in one JSON format.

Skip building and maintaining an OLX scraper per country or paying for separate Apify actors: API.SH gives you one key, one JSON shape across countries and a fixed price per 1,000 calls.

OLX API questions

What OLX data can I get?+

Listing search with filters (/olx/v1/search), one listing with description, attributes, location and seller summary (/olx/v1/item), category pages with subcategories and counts (/olx/v1/category) and seller profiles with their listings (/olx/v1/seller).

How much does the OLX API cost?+

Every OLX endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /olx/v1/category at 1 credit each.

Is there an official OLX API?+

Yes, in several countries. OLX developer portals offer a partner API for posting and managing ads, and access needs an OLX account and OAuth. API.SH only reads public listings, so there is no partner approval or token.

Do I need a OLX account or login?+

No. API.SH reads public OLX pages only. No endpoint uses a login, cookies or anyone's account.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /olx/v1/search with q set to a keyword and country set to PL, UA, RO, BG, PT, KZ, UZ or IN. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

Which OLX countries are covered?+

Search, item and seller work for PL, UA, RO, BG, PT, KZ, UZ and IN. Category pages cover all of these except India. The domain of a listing link sets the country automatically.

Can I use the OLX API from Python?+

Yes. It is a plain HTTPS API, so requests, the Python SDK or any HTTP client works. Pass next_page back as page for more results. Category attribute filters, like filter_float_year:from=2018, pass through as extra query parameters.