# Yell.com UK Business Directory Scraper

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

Scrapes structured business listing data from Yell.com (UK business directory) by search term and location, returning names, phones, emails, websites, and social profiles.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/yell?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yell-com-uk-business-directory-scraper-03141372
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nX9bhP_eP1rEtOWCllEht

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 yell-com-uk-business-directory-scraper-03141372 -d '<json body>'
```

Example prompt: Search Yell.com for 'plumbers' in London and Manchester, grab up to 100 listings, and pull back their names, phone numbers, emails, and websites — including full detail pages.

## When to prefer this

Choose this endpoint when you need structured UK business contact data (phones, emails, websites, socials) from Yell.com specifically, especially for local trade categories or city-level searches. It is ideal for lead generation, market research, or building business directories for UK regions. Prefer this over generic web scrapers when you want pre-structured Yell listing fields without parsing HTML yourself.

## Known failure modes

- Empty results if search terms or locations produce no Yell.com listings
- Proxy or rate-limiting errors from Yell.com blocking the scraper
- Partial data if individual detail pages are unavailable or blocked
- No charge issued for failed or empty runs
- maxItems or maxPages limits cutting off results before all data is retrieved

## 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 listing items, each containing fields such as name, slug, email, phone, phones array, social profiles, website URL, and listing ID. The product field confirms the source as 'yell'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "proxy": {
   "type": "object",
   "default": {
    "useApifyProxy": true
   },
   "description": "Connection setting for UK directory requests."
  },
  "maxItems": {
   "type": "integer",
   "default": 50,
   "minimum": 1,
   "description": "Stop after this many unique business rows across all searches."
  },
  "maxPages": {
   "type": "integer",
   "default": 20,
   "maximum": 400,
   "minimum": 1,
   "description": "Maximum 25-result pages to request for each term and location."
  },
  "locations": {
   "type": "array",
   "description": "UK city or area names. Leave empty for a nationwide search."
  },
  "startUrls": {
   "type": "array",
   "description": "Search or business profile URLs on yell.com. These can be used without search terms."
  },
  "searchTerms": {
   "type": "array",
   "description": "Business categories or services to search. Each term is combined with every location."
  },
  "scrapeDetails": {
   "type": "boolean",
   "default": true,
   "description": "Request each listing detail route for additional public fields."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "slug": null,
    "email": null,
    "phone": null,
    "phones": null,
    "social": null,
    "website": null,
    "listingId": null
   }
  ],
  "product": "yell"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yell-com-uk-business-directory-scraper-03141372/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)