Sign in Get API key
OLX Poland API

OLX Poland Scraper API for Classified Search, Ad Details, and Location Lookups

Scrappa's OLX Poland API returns public olx.pl classifieds as structured JSON. Search ads by keyword, category, region, city, district and price range with sort and offset pagination, open any ad for its price, parameters, location, photos and seller type, and resolve region, city and district ids with the location endpoints. Seller names, phone numbers and other contact data are never returned. Scrappa is an independent service and is not affiliated with or endorsed by OLX.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
6
Endpoints
16
Regions
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/olx-pl/search?query=rower&price_from=500&price_to=1500&limit=3" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "total": 67118,
    "offset": 0,
    "limit": 3,
    "next_offset": 3,
    "results": [
      {
        "id": 1105127075,
        "url": "https://www.olx.pl/d/oferta/lekki-rower-rozmiar-m-CID767-ID1cN02f.html",
        "title": "Lekki rower rozmiar M",
        "created_at": "2026-10-15T13:26:07Z",
        "price": { "value": 500.0, "currency": "PLN", "label": "500 zł" },
        "params": [{ "key": "state", "name": "Stan", "value": "Używane" }],
        "seller_type": "private",
        "location": { "city": "Krosno", "city_id": 9359, "region": "Podkarpackie", "region_id": 17 }
      }
    ]
  },
  "meta": { "endpoint_family": "search", "billable": true }
}

What you can build

Structured data for real applications. Here are some ideas.

Price Monitoring

Track asking prices for a product or category across Poland, with numeric PLN prices, negotiable flags and the original label.

Regional Market Research

Compare supply and prices by region, city and district using the id lookups and the city and distance filters.

Private vs Business Sellers

Filter by private or business sellers to separate consumer ads from dealer stock.

Fresh Ad Alerts

Sort by newest and poll the search endpoint to catch new ads for a query as soon as they are listed.

Category Analytics

Read the ad parameters such as brand, condition, year and mileage already parsed into key, name and value.

OLX Poland scraper API

OLX Poland API for classified ads, prices, and locations

The OLX Poland API is built for price monitoring, market research and alerting on olx.pl. Each ad carries id, url, title, description, ISO 8601 times, a numeric PLN price with currency, parsed parameters, location names with ids, photos and seller type.

Search by keyword, category id, region, city, district, distance, price range and seller type.

Sort by relevance, newest or price and page with offset and limit up to 50.

Open any ad for its parameters, location, photos and seller type.

Resolve region, city and district ids with three lookup endpoints and one name search.

Seller names, phone numbers and contact details are never returned.

Choose the right OLX Poland API endpoint

Use Search for market coverage

Combine a keyword with price, city and distance filters to collect matching ads. The response carries the real total and a next_offset while more rows are reachable.

Open OLX Poland Search API docs

Use Listing for full ad records

Open an ad by id to get its description, all photos, parameters and valid-until date. An unknown or expired id answers a non-billable 404.

Open OLX Poland Listing API docs

Use Locations to find ids

Look up a city by name with the locations endpoint, then pass its id to Search. Regions, cities and districts are listed by their own endpoints.

Open OLX Poland Locations API docs

Available endpoints

Everything you need in one API.

Related resources

Otomoto API overview

Add Polish vehicle listings from Otomoto alongside OLX classifieds.

Otodom API overview

Add Polish real-estate listings from Otodom.

Gumtree API overview

Compare with classified ads from the UK and Australia.

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to the official API.

OLX Poland ads as JSON
Scrappa:
ScrapingBee / ScraperAPI: Build your own parser
Location id lookups
Scrappa:
ScrapingBee / ScraperAPI: Parse it yourself
Price per 1k requests
Scrappa: From $0.20
ScrapingBee / ScraperAPI: Varies by credits per request
Unified API key
Scrappa: Yes (80+ APIs)
ScrapingBee / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
ScrapingBee / ScraperAPI: Trial credits

Key features

Ad search by keyword, category, region, city, district, distance, price range and seller type
Numeric PLN prices with currency, negotiable flag and the original label
Offset pagination with the real total and a next_offset
Full ad details with parameters, location names and ids, and photos
Region, city and district id lookups plus name search
Seller names, phone numbers and contact details are never returned

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by OLX. The OLX Poland API returns structured JSON from public olx.pl ads through a Scrappa API key.

Every Scrappa account includes 500 free credits each month. After that, each successful request costs one credit. Failed requests and unknown ads are never billed.

Use offset and limit, with limit up to 50. OLX makes at most 1000 rows reachable per query, so next_offset stops at offset 1000. The total field shows the real number of matching ads.

No. An unknown or expired ad id answers a non-billable 404 with error code NOT_FOUND. A search with no results is a valid empty answer and is billed.

Start using the OLX Poland API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation