# Poland Yellow Pages Business Directory Scraper

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

Scrapes structured business listings from Poland's Yellow Pages directory (PolandYP) by category and/or city, returning company names, addresses, phones, and profile details.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/poland?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/poland-yellow-pages-business-directory-scraper-4fec0111
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HQdD3Ukae0eL_YOXjUEPY

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 poland-yellow-pages-business-directory-scraper-4fec0111 -d '<json body>'
```

Example prompt: Pull up to 50 restaurant listings from Poland's Yellow Pages in Kraków, including their addresses, phone numbers, and website details from each company profile.

## When to prefer this

Choose this endpoint when you need structured business contact data (names, phones, addresses) from Poland's Yellow Pages directory, especially for lead generation, market research, or building Polish business datasets by category and/or city. It is preferable to generic web scrapers because it returns a normalized schema specifically for PolandYP listings and only charges on successful, non-empty results.

## Known failure modes

- Empty result set if the category or city name is misspelled or not found on PolandYP (not charged)
- No charge on failed or empty runs, but the caller receives an empty items array
- Rate limiting or blocking by the source site may cause partial results
- Invalid startUrls may be silently skipped
- maxItems=0 with a large category may result in very long run times

## 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 records and an array of business items. Each item may include company name, city, address, country, phone, mobile phone, listing ID, and listing URL. When includeDetails is true, additional profile fields such as website, description, categories, and business hours are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string",
   "description": "Optional Polish city name to narrow the selected category, such as Kraków or Warszawa."
  },
  "category": {
   "type": "string",
   "description": "Category name or URL slug to browse, such as Restaurants, Lawyers, or Construction_services. Used when start URLs are empty."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Stop after this many unique company records across all supplied URLs. Set 0 for no fixed cap."
  },
  "startUrls": {
   "type": "array",
   "default": [],
   "description": "Optional PolandYP category or company profile URLs. When supplied, these take precedence over category and city."
  },
  "includeDetails": {
   "type": "boolean",
   "default": true,
   "description": "Visit each company profile to collect website, description, categories, hours, and other profile details."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "city": null,
    "phone": null,
    "address": null,
    "country": null,
    "listingId": null,
    "listingUrl": null,
    "companyName": null,
    "mobilePhone": null
   }
  ],
  "product": "poland"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/poland-yellow-pages-business-directory-scraper-4fec0111/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)