{"uid":"cap_2O9KcmNs17b2cdJWxSN2M","slug":"yell-com-uk-business-directory-scraper-a83f8a93","name":"Yell.com UK Business Directory Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_bF9IK7kVJYJ9dvXhm0LHp","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, returning contact details, social links, and other public profile fields for UK businesses matching specified search terms and locations.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Local trade lead generation","prompt":"Search yell.com for 'electricians' in Birmingham and Leeds, pull up to 50 listings with full details including phone, email, and website — I need this to build a contact list for outreach."},{"title":"Competitor landscape research","prompt":"Pull all the hair salons listed on yell.com in Edinburgh, up to 30 results, and grab their names, websites, and social media links so I can see who the main players are."},{"title":"Supplier discovery by trade","prompt":"Search yell.com for 'commercial cleaning services' across Bristol and Cardiff, get up to 20 business listings with contact details — I want phone numbers and emails for each one."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:26:26.190Z","isFirstParty":false,"canonicalSlug":"yell-com-uk-business-directory-scraper-a83f8a93"}