# Yell Business Details Scraper (`ecomscrape/yell-business-details-scraper`) Actor Extract comprehensive business data from Yell.com with our professional scraping tool. Automate collection of company profiles, contact details, ratings, and 20+ data points in structured JSON format. Perfect for lead generation, market research, and sales intelligence. - **URL**: https://apify.com/ecomscrape/yell-business-details-scraper.md - **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 31 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $20.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Contact If you encounter any issues or need to exchange information, please feel free to contact us through the following link: [My profile](https://apify.com/ecomscrape) ## What does Yell.com Bussiness Details Scraper do? ### Introduction Yell.com stands as the UK's premier online business directory, evolved from the traditional Yellow Pages and launched in 1996. With over 3 million business listings, this platform serves as a crucial marketplace connecting customers with local services across the United Kingdom. For businesses, researchers, and marketers, extracting data from Yell.com can provide invaluable insights into the UK's local business landscape, competitive analysis opportunities, and comprehensive market intelligence. The platform has been helping businesses and customers connect for decades, originally as part of the General Post Office (GPO) telephone directory starting in 1966. Today's digital version offers rich business profiles containing detailed information that can drive informed business decisions, lead generation campaigns, and market research initiatives. ### Overview of the Yell.com Business Data Scraper The Yell.com Business Data Scraper is a sophisticated tool designed to extract comprehensive business information from individual business profile pages on the Yell.com platform. This scraper automates the process of collecting detailed business data that would otherwise require hours of manual research and documentation. The scraper is particularly valuable for market researchers, business development professionals, competitive analysts, and digital marketing agencies who need access to structured UK business data. Unlike generic web scraping tools, this scraper is specifically optimized for Yell.com's unique page structure and data organization, ensuring reliable and consistent data extraction. Key advantages include automated data collection at scale, structured output formats ready for analysis, and the ability to gather rich business intelligence including customer reviews, ratings, and operational details. The tool is designed for professionals who require accurate, up-to-date business information for strategic decision-making and market analysis. ### Input and Output Specifications Example url 1: https://www.yell.com/biz/apex-home-improvements-st-neots-901770225/ Example url 2: https://www.yell.com/biz/bowerham-butchers-ltd-lancaster-1913185/ Example url 3: https://www.yell.com/biz/gregory-williams-butchers-lancaster-8800364/ Example Screenshot of bussiness information page: ![](https://i.ibb.co/4gN6378p/Screenshot-from-2025-06-26-00-27-56.png) #### Input Format The scraper accepts a JSON configuration that provides flexibility and control over the data extraction process: ```json { "max_retries_per_url": 2, // Maximum waiting time when accessing the links you provided. "proxy": { // Add a proxy to ensure that during the data collection process, you are not detected as a bot. "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "SG" // You should choose an Country that coincides with the Country you want to collect data from }, "max_items_per_url": 20, // Total page you want scrape "urls": [ // Links to bussiness list by query pages. "https://www.yell.com/biz/apex-home-improvements-st-neots-901770225/", "https://www.yell.com/biz/gregory-williams-butchers-lancaster-8800364/", "https://www.yell.com/biz/bowerham-butchers-ltd-lancaster-1913185/" ] } ``` **Input Parameters Explained:** - `max_retries_per_url`: Controls persistence when accessing URLs, ensuring reliable data collection even with temporary connectivity issues - `proxy` configuration: Implements residential proxy rotation to maintain anonymity and avoid detection as automated traffic - `apifyProxyCountry`: Should match the target market geography for optimal performance - `max_items_per_url`: Limits the number of business profiles processed per URL to manage resource usage - `urls`: Array of specific Yell.com business profile URLs to scrape #### Output Format You get the output from the Yell.com Bussiness Details Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor. ```json [ // List of bussiness information { "id": "https://www.yell.com/biz/apex-home-improvements-st-neots-901770225/", "url": "https://www.yell.com/biz/apex-home-improvements-st-neots-901770225/", "name": "Yell", "tagline": "We are a local business providing great results.", "review": [ { "star": 5, "total_reviews": 7 }, { "star": 4, "total_reviews": 0 }, { "star": 3, "total_reviews": 0 }, { "star": 2, "total_reviews": 0 }, { "star": 1, "total_reviews": 0 } ], "rating": { "score": 5.0, "total_ratings": 7 }, "address": null, "geo": null, "telephone": "01480 270004", "website": "https://www.facebook.com/profile.php?id=61563565050327", "logo": "https://c.yell.com/t_bigRect,f_auto/4f5e17f6-684c-4fa7-ac54-e27c0fcabc56_image_png.png", "open_hours": null, "breadcrumbs": [ "Home", "Decking", "St. Neots", "Decking near St. Neots" ], "payment_methods": [ "Cash", "BACS" ], "contact_links": [ "https://www.facebook.com/profile.php?id=61563565050327", "https://instagram.com/apex_home_improvements_", "https://maps.app.goo.gl/jmigsbS9dTNUfPhcA" ], "overview": "
\n

At Apex Home Improvements we offer a comprehensive range of professional garden design, hard and soft landscaping and grounds management to all commercial, industrial and domestic customers.

\n

We work with YOU to ensure that all our landscaping meets YOUR requirements and exceeds YOUR expectations, we offer an expert and professional garden design service alongside the landscaping which is carried out to the highest standards.

\n

We can undertake works on any size of garden and landscaping project and we offer a full and professional grounds management service to compliment your garden and landscaped areas.

\n

We have a keen eye for detail and have plenty of ideas about what goes where and are always enthusiastic about brightening up someone's garden and trying to make them that little bit different!

\n

From garden clearance to designing and building gardens from scratch we have completed many patios and interesting garden designs from concept to completion. Not only laying patios but fences, turfing jobs, turning unused areas of gardens into eye catching colourful areas and everything else in between.

\n

If you have an area of the garden you just don't know what to do with then we can help you out, just take a quick look at the photos of some of the designs we have done.

\n
", "photos": [ "https://c.yell.com/t_bigSquare,f_auto/afefe7d2-cd32-4b68-82e3-f5407a72ee06_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/dc29cf20-bbb7-4790-8c58-37b329f2a8a6_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/cfbbd244-1be5-47d6-8fd5-0ddb4ff83102_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/bb51cd7e-4242-4c96-9cd7-18a1eccb09bf_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/72268c34-c834-4f4c-947b-d90cb06bcd89_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/36033653-01d5-4171-9796-7906977f2873_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/5194ad73-83de-49b9-9417-a85f9240f573_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/67f99d20-cb64-4ef3-8e2d-ccdfabf374aa_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/e4ed2640-7399-4510-b144-86365d26d076_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/ee116a0a-bb89-458e-a1b2-66b8e8dd3bc6_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/4915f76f-f54f-434f-8b4b-c9a82417787c_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/ae3de9b7-3b65-4448-b61e-be35d6eb2e6a_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/d3782fcb-f7e6-43e1-ad6f-3d595e4600ce_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/fdad468c-d997-4e37-8255-b66e3b3a2ae5_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/19258976-fe82-4a3b-8e39-6cd01bbe39a3_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/1f0f9deb-c896-41cc-b762-88fa26251eb0_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/09e7d658-0d02-4a35-ae5b-3144145553b0_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/6b11defd-8bb9-487e-bded-b1aa89d6d3b7_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/6f5a6a10-5b4b-45d2-b3e8-536d3679f56d_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/f81160b3-3e0c-49ed-96ce-2cb4410f3d16_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/d9f21758-644c-442b-908d-05c799889b00_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/e2da4db4-aa81-4f16-8a1b-53d82929e58d_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/44bd4ccf-bdc2-44a2-8ae1-c73241363bc3_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/3f8c4de4-ac2b-43a5-aa35-d36211ef98a8_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/db30148a-7343-494f-8076-89089099b3b1_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/f04df082-5ae8-4174-91d7-54a88e028090_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/4a16f970-0c98-41e4-bb78-0be2cf52c5fd_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/9a1437af-6657-442f-987f-0a8b3ca5d847_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/56f8ccd8-c6b9-4ce6-9224-72f9f047ab46_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/58326830-d0df-4af7-877d-77d2aa0d9cdc_image_jpeg.jpg", "https://c.yell.com/t_bigSquare,f_auto/ebb466a1-28e3-46e0-88b6-8f02381b58b6_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/be969ded-c79a-4887-9c3a-9f44ee09f408_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/2f5055cc-333f-4686-ac80-e9ba44664309_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/46e37b5d-f317-48c1-b704-574651a4f085_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/b593cf60-76f8-42e8-80f7-26f849d2d792_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/d923b365-241e-4c7a-8706-f73d8ebddb46_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/a8fe6ed3-72b3-43b5-95e5-4ddedf7ff78e_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/bab02911-b77e-49cc-b0e3-8a3376cd4aeb_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/4dc2e509-9515-4f06-bffb-8de89fa62ff1_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/881ea1f5-6b22-40f2-9c1c-9096ffef9b64_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/cd68c924-fb49-4d3c-91de-c62900779705_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/1fb89dab-20b5-4ce0-b654-f26d89a376e0_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/1a211aa9-981a-4536-991a-5219b0709e50_image_png.png", "https://c.yell.com/t_bigSquare,f_auto/11e242c9-aaa3-4fa4-b553-446da31ec77d_image_png.png" ], "founding_date": null, "reputation_summary_amount": null, "has_offer_catalog": [ "Artificial Grass", "Decking", "Fencing Services", "Garden Clearance", "Garden Designers", "Garden Fencing", "Garden Maintenance", "Garden Makeovers", "Garden Walling", "Grounds Maintenance", "Hard Landscaping", "Hedge Cutting", "Hedging", "Lawn Care", "Lawns", "Lawn Mowing", "Patio Design", "Patios", "Site Clearance" ], "related_searches": [ { "url": "https://www.yell.com", "title": "Garden Services" }, { "url": "https://www.yell.com", "title": "Hedge Cutting" }, { "url": "https://www.yell.com", "title": "Landscapers" }, { "url": "https://www.yell.com", "title": "Turfing Services" }, { "url": "https://www.yell.com", "title": "Patio Laying" }, { "url": "https://www.yell.com", "title": "Hard Landscaping" }, { "url": "https://www.yell.com", "title": "Tree Surgeons" }, { "url": "https://www.yell.com", "title": "Garden Waste Removal" }, { "url": "https://www.yell.com", "title": "Builders" }, { "url": "https://www.yell.com", "title": "Roof Repairs" }, { "url": "https://www.yell.com", "title": "Handyman Services" }, { "url": "https://www.yell.com", "title": "Roofing Services" } ], "business_tenure": null }, // ... Many other bussiness details ] ``` The scraper delivers comprehensive business data in a structured format with 21 distinct fields: **Core Business Information:** - **ID**: Unique identifier for each business record, essential for database management and record tracking - **URL**: Direct link to the business profile, enabling verification and further manual research - **Name**: Official business name as registered on Yell.com - **Tagline**: Marketing slogan or brief description (up to 180 characters), crucial for understanding business positioning **Customer Engagement Metrics:** - **Review**: Customer review count, indicating business reputation and customer engagement levels - **Rating**: Numerical rating score, vital for competitive analysis and quality assessment - **Reputation Summary Amount**: Aggregate reputation metrics for comprehensive evaluation **Contact and Location Data:** - **Address**: Complete business address, essential for location-based analysis and local market research - **Geo**: Geographic coordinates, enabling mapping and proximity analysis - **Telephone**: Primary contact number for direct business communication - **Website**: Official website URL, important for digital presence analysis **Visual and Operational Information:** - **Logo**: Business logo URL, useful for brand recognition and visual analysis - **Open Hours**: Operating schedule, critical for customer service analysis - **Photos**: Image gallery URLs, providing visual insight into business operations **Business Context and Categorization:** - **Breadcrumbs**: Category hierarchy, showing business classification and industry positioning - **Payment Methods**: Accepted payment options, indicating business sophistication and customer convenience - **Contact Links**: Additional communication channels and social media presence - **Overview**: Detailed business description and service offerings **Historical and Relationship Data:** - **Founding Date**: Business establishment date, useful for analyzing business maturity and market presence - **Has Offer Catalog**: Boolean indicating promotional offerings, relevant for competitive pricing analysis - **Related Searches**: Associated search terms and categories, valuable for SEO and market positioning insights - **Business Tenure**: Length of operation, providing context for business stability and market experience ### How to Use the Scraper **Step 1: Prepare Your URLs** Collect the specific Yell.com business profile URLs you want to scrape. Ensure these are individual business pages, not category or search result pages. **Step 2: Configure Proxy Settings** Set up residential proxies with appropriate geographic targeting. For UK businesses, consider using UK or European proxy locations to ensure optimal access and data accuracy. **Step 3: Set Processing Limits** Configure `max_items_per_url` and `max_retries_per_url` based on your data requirements and time constraints. Start with conservative settings and adjust based on performance. **Step 4: Execute and Monitor** Run the scraper and monitor output quality. Check for any missing data fields or potential blocking issues, adjusting proxy settings if necessary. **Best Practices:** - Use reasonable delays between requests to avoid overwhelming the server - Regularly rotate proxy configurations for sustained access - Validate extracted data for completeness and accuracy - Implement data deduplication processes for large datasets ### Benefits and Applications The Yell.com Business Data Scraper delivers significant time savings by automating what would otherwise be hours of manual data collection. A single scraping session can gather comprehensive information on hundreds of businesses, providing structured data ready for immediate analysis. **Practical Applications:** - **Market Research**: Analyze competitor landscapes, pricing strategies, and service offerings across specific geographic regions or industries - **Lead Generation**: Build targeted prospect lists with complete contact information and business intelligence - **Competitive Intelligence**: Monitor competitor reviews, ratings, and business development activities - **Location Planning**: Assess market density and business distribution for expansion or investment decisions The structured output format enables immediate integration with CRM systems, marketing automation platforms, and business intelligence tools, maximizing the value of collected data for strategic business initiatives. ### Conclusion The Yell.com Business Data Scraper represents a powerful solution for accessing the UK's most comprehensive business directory data in a structured, actionable format. By automating the extraction of detailed business profiles, this tool empowers organizations to make data-driven decisions based on comprehensive market intelligence. Whether you're conducting competitive analysis, building lead generation campaigns, or performing market research, this scraper provides the foundation for informed business strategy. Start leveraging the wealth of UK business data available through Yell.com to gain competitive advantages and drive business growth. ## Related Actors - [**Yell.com Business Search Scraper**](https://apify.com/ecomscrape/yell-business-search-scraper): Your comprehensive tool for extracting valuable business information from Yell extensive directory platform. ## Your feedback We are always working to improve Actors' performance. So, if you have any technical feedback about Yell.com Bussiness Details Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Specific business urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `max_retries_per_url` (type: `integer`): Limit the number of retries for each URL, If an error occurs during the data scraping process. ## `proxy` (type: `object`): Select proxies to be used by your scraper. ## Actor input object example ```json { "urls": [ "https://www.yell.com/biz/apex-home-improvements-st-neots-901770225/" ], "max_retries_per_url": 2, "proxy": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.yell.com/biz/apex-home-improvements-st-neots-901770225/" ], "max_retries_per_url": 2, "proxy": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("ecomscrape/yell-business-details-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://www.yell.com/biz/apex-home-improvements-st-neots-901770225/"], "max_retries_per_url": 2, "proxy": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("ecomscrape/yell-business-details-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://www.yell.com/biz/apex-home-improvements-st-neots-901770225/" ], "max_retries_per_url": 2, "proxy": { "useApifyProxy": false } }' | apify call ecomscrape/yell-business-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ecomscrape/yell-business-details-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/h9Pna28xzVK4mUckw/builds/rMoTYw6cIfsgeMWf1/openapi.json