m.olx.ro APIm.olx.ro ↗
Search and retrieve structured real estate listings from OLX.ro. Get price, area, rooms, location, photos, and description for apartments, houses, and land.
curl -X GET 'https://api.parse.bot/scraper/fedbcb5c-92db-48e1-8adb-9fec6ce76fd0/search_real_estate?limit=10&offset=0&category_path=imobiliare' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for real estate listings on OLX.ro. Provides comprehensive details for each listing including price, area, location, and description. Returns paginated results ordered by listing date.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of items to return per page. |
| offset | integer | Pagination offset. |
| category_path | string | Top-level category path/slug (e.g., 'imobiliare', 'electronice-si-electrocasnice'). Only top-level category slugs are supported for filtering; subcategory paths fall back to the default real estate category. |
{
"type": "object",
"fields": {
"items": "array of listing objects with id, title, url, posting_date, price, currency, area, rooms, location, description, and photos",
"limit": "integer number of items requested",
"total": "integer total number of listings available",
"offset": "integer current pagination offset"
},
"sample": {
"data": {
"items": [
{
"id": 295603553,
"url": "https://www.olx.ro/d/oferta/apartament-3-camere-zona-pacurari-IDk0jZf.html",
"area": "47 m²",
"floor": "Parter",
"price": 84900,
"rooms": null,
"title": "Apartament 3 camere, zona Pacurari",
"photos": [
"https://frankfurt.apollo.olxcdn.com:443/v1/files/hc0cerw9pfvf-RO/image;s={width}x{height}"
],
"currency": "EUR",
"location": {
"city": "Iasi",
"full": "Iasi, Iasi",
"region": "Iasi",
"district": null
},
"description": "Blitz va propune spre vanzare un apartament...",
"price_label": "84 900 €",
"posting_date": "2025-11-13T10:57:43+02:00",
"property_type": null,
"construction_year": "1977 – 1990",
"compartmentalization": null
}
],
"limit": 10,
"total": 52437,
"offset": 0
},
"status": "success"
}
}About the m.olx.ro API
The OLX Romania API provides access to real estate listings from m.olx.ro across 2 endpoints, returning up to 10 fields per listing including price, area, rooms, location, and photos. The search_real_estate endpoint returns paginated results with full listing detail, while get_category_id resolves category slugs like 'imobiliare' to their internal IDs for use in search queries.
What the API Returns
The search_real_estate endpoint returns an array of listing objects, each containing: id, title, url, posting_date, price, currency, area, rooms, location, description, and photos. Results are ordered by listing date and paginated via limit and offset parameters. The response also includes a total field indicating the full count of available listings matching the query, which is useful for building paginated interfaces.
Category Resolution
Before querying listings by category, use get_category_id with a path parameter to convert a top-level slug — such as imobiliare or electronice-si-electrocasnice — into an integer category_id. This ID can then be used in search_real_estate via the category_path parameter. Only top-level slugs are supported; subcategory paths will return an error from OLX.
Pagination and Coverage
Both limit and offset in search_real_estate are optional integers. Use them together to walk through result sets larger than a single page. The total field in the response tells you how many listings exist in total so you can calculate page counts programmatically. Listings cover apartments, houses, land, and other property types listed on OLX Romania.
- Aggregate Romanian property listings by category to compare apartment prices across cities using the
priceandlocationfields. - Track new listings over time by monitoring
posting_datefor a given category slug. - Build a property alert system that checks
totalperiodically and fetches new entries viaoffsetpagination. - Extract listing
photosanddescriptionto populate a property search UI with real OLX data. - Analyze average property
areaandroomscounts for market research in Romanian real estate. - Resolve category slugs to internal IDs using
get_category_idbefore feeding them into downstream search pipelines.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does OLX Romania have an official developer API?+
What does `search_real_estate` return for each listing?+
id, title, url, posting_date, price, currency, area, rooms, location, description, and photos. The response also carries total, limit, and offset for pagination.Can I query subcategories, such as only apartments within the real estate category?+
get_category_id and the category_path parameter in search_real_estate only support top-level slugs like imobiliare. Subcategory paths return an upstream error. You can fork this API on Parse and revise it to add subcategory resolution if you need more granular filtering.Does the API return seller contact details or phone numbers for listings?+
How does pagination work across large result sets?+
limit to set how many listings to return per request and offset to move through the result set. The total field in every response gives the full count of matching listings, letting you compute how many pages exist and when to stop paginating.