# Poland Yellow Pages Business Directory Scraper

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

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

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-f5e32913
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QnvQIVdR1VEBgPjluJrK-

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-f5e32913 -d '<json body>'
```

Example prompt: Can you pull me up to 50 restaurant listings from the Polish Yellow Pages in Kraków, including their addresses, phone numbers, and website details?

## When to prefer this

Use this endpoint when you need structured business data specifically from the Polish Yellow Pages directory, including contact information, addresses, and company profiles for businesses in Poland. Prefer this over general web scraping when you need organized, consistent business listing data from a known Polish directory source.

## Known failure modes

- Category or city not found on PolandYP returns empty items array
- Invalid startUrls result in no data collected
- maxItems set too low may truncate useful results
- Network or scraping blocks from the target site may return empty runs (not charged)
- Misspelled city or category names return no results

## How this service works

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

## Output

A JSON object containing a count of results and an array of business records, each with fields for company name, address, city, country, phone, mobile phone, listing URL, and listing ID. When includeDetails is true, additional profile fields such as website, description, categories, and hours may be 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-f5e32913/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)