Yellowpages API The Yellowpages API is a fast and reliable interface for extracting public business data from YP.com. Simply provide a search term (like "plumbers" or "restaurants") and a location, and this API will return structured business listings in JSON, CSV, or Excel format. This tool serves as a powerful, unofficial Yellow Pages API, allowing you to integrate business data directly into your applications, databases, or lead generation pipelines without needing complex contracts or official access tokens. ## What can the Yellowpages API do? * Retrieve Business Details: Programmatically access essential data points like business name, phone number, full address, and website. * Get Rich Operational Data: Fetch details such as business hours, accepted payment methods, "Years in Business," and social media links. * Analyze Reputation: Access star ratings, total review counts, and business categories. * Extract Media & Assets: Get URLs for gallery images, business logos, and "General Info" descriptions. * Cloud Integration: Built on the Apify platform, this API supports scheduling, webhooks, and integration with other tools (Make, Zapier, etc.) via the standard Apify API Client. ## What data endpoints are available? The API returns the following data structure for every business listing found: | Field | Description | | :--- | :--- | | crawl_url | The source URL of the listing. | | business_name | The name of the business. | | phone_number | The primary phone number. | | full_address | The complete street address, city, state, and ZIP. | | website_url | The business's website. | | rating | The average star rating (e.g., "5"). | | review_count | The total number of reviews. | | categories | A list of all business categories. | | business_hours | Formatted hours (e.g., "Mon - Fri: 9:00 am - 5:00 pm"). | | email | The business email (if publicly available). | | claimed_status | "Claimed" or "Unclaimed". | | payment_methods| List of accepted payment methods. | | social_links | List of links to social media profiles. | | general_info | The "General Info" description text. | ----- ## How to use the Yellowpages API 1. Configure Inputs: In the Apify Console, set your Search Terms (e.g., Architects) and Locations (e.g., New York, NY). 2. Set Limits: Define the Total Businesses you want to retrieve (e.g., 50). 3. Call the API: Click Start (or call the API endpoint programmatically). 4. Get Data: Retrieve your results in JSON, CSV, or Excel from the Storage tab / API response. --- ## Pricing (Pay-Per-Event) This API uses the Pay Per Event (PPE) model, ensuring you only pay for the data you successfully retrieve. | Event | Price | Description | | :--- | :--- | :--- | | API Start (apify-actor-start) | $0.00005 | Charged once per run initialization. | | Business Record (scraped-business-item) | $0.007 | Charged for each unique business profile successfully extracted. | Volume Discounts: * Bronze plan: $0.00633 / record * Silver plan: $0.00567 / record * Gold plan: $0.005 / record The API respects the Max cost per run limit you set, ensuring you never go over budget. --- ## JSON Response Example The API returns a clean JSON object for each business: json [{ "crawl_url": "[https://www.yellowpages.com/new-york-ny/mip/jbj-concept-523768808](https://www.yellowpages.com/new-york-ny/mip/jbj-concept-523768808)", "business_name": "JBJ Concept", "phone_number": "(646) 221-9138", "full_address": "313 E 61st St, New York, NY 10065", "website_url": "[http://www.jbjconcept.com](http://www.jbjconcept.com)", "rating": "5", "review_count": "12", "categories": [ "Architects & Builders Services", "Architectural Designers" ], "general_info": "A multitalented interior designer...", "logo_url": "[https://i3.ypcdn.com/blob/](https://i3.ypcdn.com/blob/)...", "payment_methods": ["discover", "master card", "visa", "amex"], "neighborhoods": ["Upper East Side", "Upper Manhattan"], "social_links": ["[https://facebook.com/](https://facebook.com/)..."], "email": "joseph.by@hotmail.com", "business_hours": "Mon - Thu: 10:00 am - 8:00 pm | Fri: 10:00 am - 3:00 pm...", "claimed_status": "Claimed", "years_in_business": "22 Years in Business" }] ```` ----- ## Technical Notes & Support * **Proxy Requirement:** YP.com is a US-based directory. This API requires **US Residential Proxies** to function correctly. The default configuration handles this automatically. * **Support:** If you encounter issues or need specific fields added to the API response, please use the **Issues** tab. ## Legal & Compliance This API is designed to scrape only public data. It does not extract private user data. However, users must respect local regulations regarding data usage (such as GDPR or CCPA). Please read our blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) for more information. ```