# German Business Directory Scraper (com.de / gelbeseiten-style)

> German Business Directory Scraper (com.de / gelbeseiten-style) 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 German business listings (name, email, phone, address, type) from a German business directory by city and keyword.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/com?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/german-business-directory-scraper-com-de-gelbeseiten-style-0ecf9717
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KRVeVnOpMvepBLRKFRagd

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 german-business-directory-scraper-com-de-gelbeseiten-style-0ecf9717 -d '<json body>'
```

Example prompt: Search the German business directory for up to 50 hotels and restaurants in Berlin and Hamburg — include their website, coordinates, and opening hours.

## When to prefer this

Use this endpoint when you need structured contact and location data for German businesses from a local business directory, especially for lead generation, market research, or business enrichment tasks targeting Germany. Ideal when you need bulk results across multiple cities and business types with optional detail enrichment. Prefer over generic web scraping when you want clean, schema-consistent output at a low per-call cost with no charge for failed runs.

## Known failure modes

- Empty results if keywords or cities don't match directory listings — not charged
- Rate or page limit hit if maxPagesPerSearch or maxItems is set low
- Directory site redirects after page 5, so pagination is capped
- Partial data if includeDetails is false (no website, coordinates, fax, or hours)
- Slow response when includeDetails is true due to extra page fetches

## 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 results and an array of business records. Each record may include: business name, email, phone number, business ID, postal code, business URL, business type, and street address. With includeDetails enabled, records can also include the business website, GPS coordinates, fax number, and opening hours.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cities": {
   "type": "array",
   "default": [
    "Berlin"
   ],
   "description": "Cities to search, such as Berlin or Hamburg. Each city is combined with every keyword."
  },
  "queries": {
   "type": "array",
   "description": "German business types or company keywords to search, such as Hotel or Friseur. Each query is searched in every city."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum unique businesses across all searches. Set 0 for no total cap."
  },
  "includeDetails": {
   "type": "boolean",
   "default": false,
   "description": "Open each business page to add its public website, coordinates, fax, and opening hours. This uses more requests and takes longer."
  },
  "maxPagesPerSearch": {
   "type": "integer",
   "default": 2,
   "maximum": 5,
   "minimum": 1,
   "description": "Maximum search pages per keyword and city pair. Each page holds up to 50 listings; the site currently redirects after page 5."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "email": null,
    "phone": null,
    "businessId": null,
    "postalCode": null,
    "businessUrl": null,
    "businessType": null,
    "streetAddress": null
   }
  ],
  "product": "com"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/german-business-directory-scraper-com-de-gelbeseiten-style-0ecf9717/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)