# OLX Poland Listings Scraper

> OLX Poland Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured listing data from OLX.pl (Polish classifieds marketplace) based on search queries or category URLs.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/olx?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/olx-poland-listings-scraper-e54bf423
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Xt4QR_27Lgeh25jtfAOmL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability olx-poland-listings-scraper-e54bf423 -d '<json body>'
```

Example prompt: Search OLX Poland for used iPhone 13 listings, sort by newest, return up to 50 results priced between 1000 and 3000 złoty.

## When to prefer this

Choose this endpoint when you need structured listing data from OLX Poland specifically — it handles Polish-language queries, preserves URL-level filters, supports price filtering in złoty, and covers both private and business sellers. Prefer it over generic web scrapers when you want clean, parsed listing fields (price, title, ID, negotiability) without HTML parsing.

## Known failure modes

- Empty results if search query returns no OLX matches — not charged
- Invalid or non-OLX URL passed in searchUrls — may return error or empty
- minPrice greater than maxPrice produces no results
- OLX rate limiting or site changes could cause partial or failed scrapes — not charged on failure
- maxResults set to 0 with very broad query may hit the 50,000 listing cap

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of matched listings and an array of items, each containing the listing URL, title, price (numeric), currency, listing ID, description text, negotiable flag, and formatted price display string. Also includes a product identifier ('olx').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sortBy": {
   "enum": [
    "relevance",
    "newest",
    "price_asc",
    "price_desc"
   ],
   "type": "string",
   "default": "relevance",
   "description": "Ordering for sources without a sort already selected in their URL. Promoted listings may appear ahead of organic listings."
  },
  "maxPrice": {
   "type": "integer",
   "minimum": 0,
   "description": "Only return listings priced at or below this amount in Polish złoty. Overrides the maximum in a search URL."
  },
  "minPrice": {
   "type": "integer",
   "minimum": 0,
   "description": "Only return listings priced at or above this amount in Polish złoty. Overrides the minimum in a search URL."
  },
  "maxResults": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum unique listings across all sources. Set to 0 to collect as many as available, up to 50,000. Broad searches have a source pagination cap; use narrower URLs for more coverage."
  },
  "searchUrls": {
   "type": "array",
   "description": "Public olx.pl search or category URLs. Filters already present in a URL are preserved."
  },
  "searchQueries": {
   "type": "array",
   "description": "Plain text terms to search across OLX Poland, such as rower or iPhone 13. Can be combined with search URLs."
  },
  "includeBusinessOnly": {
   "type": "boolean",
   "default": false,
   "description": "Restrict results to listings marked as business advertisements."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "price": null,
    "title": null,
    "currency": null,
    "listingId": null,
    "description": null,
    "isNegotiable": null,
    "priceDisplay": null
   }
  ],
  "product": "olx"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/olx-poland-listings-scraper-e54bf423/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)