{"uid":"cap_nX9bhP_eP1rEtOWCllEht","slug":"yell-com-uk-business-directory-scraper-03141372","name":"Yell.com UK Business Directory Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/yell?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"name":null,"slug":null,"email":null,"phone":null,"phones":null,"social":null,"website":null,"listingId":null}],"product":"yell"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UHxc56JXwknU8LkjCr8vA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured business listing data from Yell.com (UK business directory) by search term and location, returning names, phones, emails, websites, and social profiles.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"UK lead generation by trade","prompt":"Search Yell.com for 'electricians' in Leeds and Sheffield, get up to 50 businesses, and extract their phone numbers, emails, and websites so I can build a contact list."},{"title":"Local restaurant directory research","prompt":"Scrape Yell.com for restaurants in Edinburgh — I want the business names, phone numbers, and websites for up to 30 listings across a maximum of 5 pages each."},{"title":"Competitor landscape mapping","prompt":"Pull all the listings for 'accountants' across Birmingham and Coventry from Yell.com — up to 80 results — and include their social media profiles and email addresses."}],"resultDescription":"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'.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T02:46:29.543Z","isFirstParty":false,"canonicalSlug":"yell-com-uk-business-directory-scraper-03141372"}