# OLX Poland Marketplace Scraper

> OLX Poland Marketplace Scraper is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured product listings from OLX Poland (olx.pl) given search queries or category URLs, returning titles, prices, and listing metadata.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-marketplace-scraper-1098c214
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2Y7zcfMvn8pGdhMetwOPK

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-marketplace-scraper-1098c214 -d '<json body>'
```

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

## When to prefer this

Choose this endpoint when you specifically need structured listing data from OLX Poland (olx.pl) — Poland's largest classifieds marketplace — with support for Polish złoty price filtering, sort ordering, and mixing free-text queries with direct category URLs. Prefer this over generic web scrapers when you need clean, pre-structured marketplace fields (price, title, negotiability) without post-processing.

## Known failure modes

- No listings found for query returns count:0 with empty items array (not charged)
- Invalid or inaccessible OLX URL returns an error (not charged)
- Rate limits or OLX anti-scraping blocks may result in empty or partial results
- Incorrect price filter values (e.g. minPrice > maxPrice) may return empty results
- Non-olx.pl URLs in searchUrls field will be ignored or error

## How this service works

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

## Output

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, full description text, negotiability flag, and a formatted price display string. The product field confirms '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-marketplace-scraper-1098c214/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)