# Yell.com UK Business Directory Scraper

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

Scrapes structured business listing data from yell.com, returning contact details, social links, and other public profile fields for UK businesses matching specified search terms and locations.

## Facts

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

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

Example prompt: Search yell.com for 'plumbers' in London and Manchester, scrape up to 100 business listings including their phone numbers, emails, and websites, and return the full contact details for each.

## When to prefer this

Use this endpoint when you specifically need structured business contact data from the UK yell.com directory, including phone, email, website, and social fields. Prefer this over generic web scrapers when targeting UK local businesses by trade category and city, or when you need structured multi-field output rather than raw HTML.

## Known failure modes

- Empty results if search terms or locations return no yell.com matches
- Rate limiting or proxy failures causing incomplete page retrieval
- Partial data if business profiles lack contact fields (null values returned)
- maxItems or maxPages limits hit before all results are collected
- yell.com page structure changes breaking the scraper extraction

## 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 listings and an array of business records, each containing name, slug, email, phone, phones array, social links, website URL, and listing ID as available from the yell.com public profile.

## 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-a83f8a93/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)