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:

[{
  "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 for more information.