Yell.com Scraper

Turn a Yell search into structured UK business rows: name, phone, email when listed, website, address, hours, rating, and profile link.

Keyword + city, nationwide UK, or a yell.com URL. JSON or CSV out.

This is yell.com (UK). It is not Yellow Pages US, Yellow Pages Canada, or Yelp.

Why Use This Scraper?

• Phone and address on the search card
• Profile pass for hours, extra website/email, and reviews
• Pretty /s/{what}-{where}.html URLs and UCS searches
• Uses the official Android listings API, so Unblocker is not required

Overview

Built for sales teams, agencies, and researchers who need UK business leads from Yell.

Every start type becomes one dataset row per listing. A keyword search and a /biz/{slug}/ profile emit the same flat shape. Rows are de-duplicated by listing id.

Supported Inputs

Search terms and locations

Field	Example
searchTerms	["restaurants"], ["plumbers", "solicitors"]
locations	["London"], ["Manchester"], ["Glasgow"]

Every term is searched in every location. Leave locations empty for a nationwide UK category search.

URL types

URL type	Pattern	Example
Pretty search	/s/{what}-{where}.html	https://www.yell.com/s/restaurants-london.html
Search page	?pageNum=N	https://www.yell.com/s/restaurants-london.html?pageNum=2
UCS search	/ucs/UcsSearchAction.do?keywords=&location=	https://www.yell.com/ucs/UcsSearchAction.do?keywords=plumbers&location=Manchester
Profile	/biz/{slug}/	https://www.yell.com/biz/dishoom-covent-garden-london-3420007/

Search URLs paginate automatically.

Unsupported: Yelp, Yellow Pages US/CA, Yell ads manager, account pages.

Use Cases

Audience	What they take from a run
Sales and outreach	Phone + email (when listed) + website by trade and city
Agencies	Cross-joined term × city lists in one dataset
Local SEO	Category, rating, and the Yell profile URL
Researchers	Hours and reviews for a trade in a city

How It Works

1. Cross-join searchTerms × locations (or nationwide UK if no city), plus any yell.com URLs.
2. Call the same listings API the official Yell Android app uses (keywords + location + pageNum).
3. Page in 25-row chunks, stopping at maxItems or maxPages.
4. Read name, phone, website, address, hours, and rating from each listing.
5. Optionally load the single-listing endpoint, then the business website when Yell has no inbox.
6. De-duplicate by listing id and push one row per business.

Input Configuration

Field	Type	Required	Notes
searchTerms	array	one of the start types	What you would type into Yell
locations	array	no	UK city / area. Empty = nationwide
startUrls	array	one of the start types	Search or /biz/ URL
maxItems	integer	no	Default 50. Free users capped at 50.
scrapeDetails	boolean	no	Default true. Hours, extra website/email, reviews.
maxPages	integer	no	Default 20.
maxConcurrency	integer	no	Default 5.
proxy	object	no	Default is Apify residential, country GB. Do not use Unblocker.

Example input

{
  "searchTerms": ["restaurants"],
  "locations": ["London"],
  "maxItems": 50
}

Output Overview

One flat row per business. Contact and address fields sit at the top level. searchTerm tells you which input produced the row. Email is present when Yell publishes one on the card or the profile.

Output Samples

Search: restaurants in London, with profile enrich.

{
  "listingId": "dishoom-covent-garden-london-3420007",
  "name": "Dishoom Covent Garden",
  "phone": "02074209320",
  "email": "coventgarden@dishoom.com",
  "street": "12 Upper St Martin's Lane",
  "postalCode": "WC2H 9FB",
  "city": "London",
  "country": "GB",
  "yellUrl": "https://www.yell.com/biz/dishoom-covent-garden-london-3420007/"
}

Key Output Fields

Identity: listingId, slug, name, yellUrl

Contact: phone, phones, email, website, social

Place: address, street, postalCode, city, region, country, latitude, longitude

Directory: category, categories, rating, reviewCount, hours, description, images, logo, reviews

Provenance: searchTerm, scrapedAt

Pricing

Event	When	Rate
Actor start	Once per run, per GB of memory	$0.005
Listing	Each unique business in the dataset	$0.005 ($5 / 1k)
Contact phone	Row has a phone	$0.002
Contact email	Row has an email	$0.05

Phone and email are billed only when Yell publishes that field. A miss is free. Phone is common on search cards. Inbox is rarer; keep scrapeDetails on if you want the extra chance.

FAQ

Will every row have an email? No. Phone is common. Inbox is on a smaller share of cards and profiles. Phone and email are billed as extra events only when the field is present.

What does scrapeDetails add? The single-listing API (hours, extra website, reviews) plus the business website when Yell has no inbox. Phone is already on almost every search row.

Do I need a proxy? Yes — Apify residential (GB). The listings API rejects datacenter IPs. You do not need Unblocker.

Is there an official Android app? Yes — “Yell - Find Local Businesses” by YELL LIMITED (com.yell.launcher2) is live on Play. This actor uses that same listings API.

Support

• Issues: Actor Issues
• Author site: https://muhamed-didovic.github.io/
• Email: muhamed.didovic@gmail.com

Additional Services

Bulk city sweeps, scheduled refreshes, or a private API wrapper: muhamed.didovic@gmail.com

Explore More Scrapers

Directory cousins: PanoramaFirm.pl, PaginasAmarillas.es, Herold.at, PagineGialle, local.ch, Gelbe Seiten, Yellow Pages US, Yellow Pages Canada, Canada411, and PagesJaunes.fr. More actors on memo23 and didovic.

🤖 For AI Agents & LLM Apps

Compact reference for AI agents calling this actor via the Apify MCP server or the Apify API (actor: memo23/yell-scraper).

Purpose: Extract Yell.com UK business listings (name, phone, email when listed, website, split address, hours) by keyword + city or URL.

Minimal input:

{
  "searchTerms": ["restaurants"],
  "locations": ["London"],
  "maxItems": 10
}

Output: one dataset row per business — listingId, slug, name, phone, phones, email, website, social, address, street, postalCode, city, region, country, latitude, longitude, category, categories, rating, reviewCount, hours, description, images, logo, reviews, yellUrl, searchTerm, scrapedAt.

Behaviors an agent should know:

• Always set maxItems. Free users are capped at 50.
• searchTerms without locations runs a nationwide UK category search.
• startUrls work on their own (yell.com only).
• Phone is often already on the search card. Keep scrapeDetails true for hours and a second look at email.
• Each listing is $0.005. A phone on the row is $0.002. An email is $0.05. Start is $0.005 per GB.
• UK directory only. Not Yelp.

⚠️ Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Yell Limited or yell.com. All trademarks mentioned are the property of their respective owners.

The scraper reads publicly listed UK business data from yell.com. Users are responsible for ensuring their use complies with Yell Terms of Service, applicable data-protection law (UK GDPR), and any contractual obligations of their own organization.

SEO Keywords

yell scraper, yell.com scraper, scrape yell.com, UK business directory scraper, UK yellow pages scraper, yell API, UK company listings scraper, London leads scraper, Apify yell, UK restaurant leads, Manchester business scraper, plumber leads UK, Yell directory scraper