Try it instantly

See real data shapes from every endpoint — no signup required.

Request

GET /yellowpages/search

query plumber required

location New York, NY required

page 1

curl -G "https://api.pullapi.com/yellowpages/search" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "query": "plumber",
    "location": "New York, NY",
    "page": 1,
    "results": [
      {
        "name": "Roto-Rooter Plumbing & Water Cleanup",
        "phone": "(212) 555-0198",
        "street_address": "456 Broadway",
        "city": "New York",
        "state": "NY",
        "zip_code": "10013",
        "full_address": "456 Broadway, New York, NY 10013",
        "categories": [ "Plumbers", "Water Heater Repair", "Drain Cleaning"
        ],
        "website": "https://www.rotorooter.com",
        "snippet": "24/7 Emergency Plumbing Services. Licensed & Insured.",
        "years_in_business": 42,
        "listing_url": "/new-york-ny/mip/roto-rooter-plumbing-12345678",
        "is_ad": false
      },
      {
        "name": "NYC Best Plumbing Inc",
        "phone": "(718) 555-0234",
        "street_address": "789 3rd Ave",
        "city": "New York",
        "state": "NY",
        "zip_code": "10017",
        "full_address": "789 3rd Ave, New York, NY 10017",
        "categories": [ "Plumbers", "Plumbing Contractors"
        ],
        "website": null,
        "snippet": "Residential and commercial plumbing services.",
        "years_in_business": 15,
        "listing_url": "/new-york-ny/mip/nyc-best-plumbing-87654321",
        "is_ad": false
      }
    ],
    "total_results": 87,
    "has_next_page": true
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Request

GET /yellowpages/business

listing_url /new-york-ny/mip/roto-rooter-plumbing-12345678 required

curl -G "https://api.pullapi.com/yellowpages/business" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "name": "Roto-Rooter Plumbing & Water Cleanup",
    "business_type": "Plumber",
    "phone": "(212) 555-0198",
    "address": {
      "street": "456 Broadway",
      "city": "New York",
      "state": "NY",
      "zip_code": "10013",
      "country": "US"
    },
    "full_address": "456 Broadway, New York, NY 10013",
    "latitude": 40.7195,
    "longitude": -74.0009,
    "website": "https://www.rotorooter.com",
    "email": "contact@rotorooter.com",
    "rating": 4.5,
    "review_count": 128,
    "price_range": "$$",
    "categories": [ "Plumbers", "Water Heater Repair", "Drain Cleaning", "Sewer Cleaning"
    ],
    "hours": [
      {
        "day": "Monday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Tuesday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Wednesday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Thursday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Friday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Saturday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Sunday",
        "hours": "Open 24 Hours"
      }
    ],
    "years_in_business": 42,
    "payment_methods": [ "Visa", "MasterCard", "American Express", "Check"
    ],
    "photo_url": "https://i4.ypcdn.com/blob/example-photo.jpg",
    "reviews": [
      {
        "author": "John D.",
        "rating": 5.0,
        "date": "03/01/2026",
        "text": "Fast response and excellent service. Fixed our leak within an hour of calling."
      },
      {
        "author": "Sarah M.",
        "rating": 4.0,
        "date": "02/15/2026",
        "text": "Professional and courteous. A bit pricey but good quality work."
      }
    ],
    "url": "https://www.yellowpages.com/new-york-ny/mip/roto-rooter-plumbing-12345678"
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

API Endpoints

2 endpoints across 2 categories.

Search

GET /yellowpages/search Search Businesses

Search Yellow Pages for local businesses by keyword/category and location. Returns paginated results with business names, phone numbers, addresses, categories, and more.

Parameters

Name	Type	Required	Description	Example
`query`	string	Yes	Business type or keyword to search for. Examples: "plumber", "restaurant", "dentist", "auto repair"	plumber
`location`	string	Yes	City and state to search in. Examples: "New York, NY", "Los Angeles, CA", "Chicago, IL"	New York, NY
`page`	integer	No	Page number for paginated results (starts at 1)	1

Example Response

{
  "success": true,
  "data": {
    "query": "plumber",
    "location": "New York, NY",
    "page": 1,
    "results": [
      {
        "name": "Roto-Rooter Plumbing & Water Cleanup",
        "phone": "(212) 555-0198",
        "street_address": "456 Broadway",
        "city": "New York",
        "state": "NY",
        "zip_code": "10013",
        "full_address": "456 Broadway, New York, NY 10013",
        "categories": [ "Plumbers", "Water Heater Repair", "Drain Cleaning"
        ],
        "website": "https://www.rotorooter.com",
        "snippet": "24/7 Emergency Plumbing Services. Licensed & Insured.",
        "years_in_business": 42,
        "listing_url": "/new-york-ny/mip/roto-rooter-plumbing-12345678",
        "is_ad": false
      },
      {
        "name": "NYC Best Plumbing Inc",
        "phone": "(718) 555-0234",
        "street_address": "789 3rd Ave",
        "city": "New York",
        "state": "NY",
        "zip_code": "10017",
        "full_address": "789 3rd Ave, New York, NY 10017",
        "categories": [ "Plumbers", "Plumbing Contractors"
        ],
        "website": null,
        "snippet": "Residential and commercial plumbing services.",
        "years_in_business": 15,
        "listing_url": "/new-york-ny/mip/nyc-best-plumbing-87654321",
        "is_ad": false
      }
    ],
    "total_results": 87,
    "has_next_page": true
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Business

GET /yellowpages/business Get Business Details

Get full business profile details including contact information, address with coordinates, business hours, payment methods, customer reviews, and photos. Requires the listing URL path from search results.

Parameters

Name	Type	Required	Description	Example
`listing_url`	string	Yes	Business listing URL path from search results. This is the `listing_url` field returned by the...	/new-york-ny/mip/roto-rooter-plumbing-12345678

Example Response

{
  "success": true,
  "data": {
    "name": "Roto-Rooter Plumbing & Water Cleanup",
    "business_type": "Plumber",
    "phone": "(212) 555-0198",
    "address": {
      "street": "456 Broadway",
      "city": "New York",
      "state": "NY",
      "zip_code": "10013",
      "country": "US"
    },
    "full_address": "456 Broadway, New York, NY 10013",
    "latitude": 40.7195,
    "longitude": -74.0009,
    "website": "https://www.rotorooter.com",
    "email": "contact@rotorooter.com",
    "rating": 4.5,
    "review_count": 128,
    "price_range": "$$",
    "categories": [ "Plumbers", "Water Heater Repair", "Drain Cleaning", "Sewer Cleaning"
    ],
    "hours": [
      {
        "day": "Monday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Tuesday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Wednesday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Thursday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Friday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Saturday",
        "hours": "Open 24 Hours"
      },
      {
        "day": "Sunday",
        "hours": "Open 24 Hours"
      }
    ],
    "years_in_business": 42,
    "payment_methods": [ "Visa", "MasterCard", "American Express", "Check"
    ],
    "photo_url": "https://i4.ypcdn.com/blob/example-photo.jpg",
    "reviews": [
      {
        "author": "John D.",
        "rating": 5.0,
        "date": "03/01/2026",
        "text": "Fast response and excellent service. Fixed our leak within an hour of calling."
      },
      {
        "author": "Sarah M.",
        "rating": 4.0,
        "date": "02/15/2026",
        "text": "Professional and courteous. A bit pricey but good quality work."
      }
    ],
    "url": "https://www.yellowpages.com/new-york-ny/mip/roto-rooter-plumbing-12345678"
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Code Examples

Get started in seconds with your preferred language.

Terminal

curl -G "https://api.pullapi.com/yellowpages/search?query=plumber&location=New York, NY" \
  -H "x-rapidapi-host: yellow-pages-scraper-api.p.rapidapi.com" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Python

import requests

url = "https://api.pullapi.com/yellowpages/search"
headers = {
    "x-rapidapi-host": "yellow-pages-scraper-api.p.rapidapi.com",
    "x-rapidapi-key": "YOUR_API_KEY"
}
params = {
    "query": "plumber",
    "location": "New York, NY",
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

JavaScript

const response = await fetch(
  "https://api.pullapi.com/yellowpages/search?query=plumber&location=New York, NY",
  {
    headers: {
      "x-rapidapi-host": "yellow-pages-scraper-api.p.rapidapi.com",
      "x-rapidapi-key": "YOUR_API_KEY"
    }
  }
);
const data = await response.json();
console.log(data);

Why PullAPI

</>

No Browser Needed

HTTP-based API. No Selenium, no Puppeteer, no headless browsers to manage.

⇄

Built-in Proxy Rotation

Automatic residential proxy rotation handles anti-bot detection for you.

⚡

Cached Responses

Smart Redis caching means faster repeated queries and lower costs.

$

Pay Per Request

No monthly commitment. Free tier included. Pay only for what you use.

Use Cases

What developers build with the Yellow Pages Scraper API.

1

Lead Generation

2

Business Directory

3

Local Market Research

4

Contact Enrichment

Related Scrapers

More APIs in Business Data.

Google Maps Scraper

Lead Generation · Local SEO Audit

Crunchbase Scraper

Startup Research · Funding Intelligence

Product Hunt Scraper

Product Discovery · Launch Tracking

LinkedIn Scraper

Talent Intelligence · Company Research

Indeed Scraper

Salary Research · Job Market Analysis

Glassdoor Scraper

Salary Benchmarking · Employer Branding

Yellow Pages Scraper API

Try it instantly

API Endpoints

Search

Parameters

Example Response

Business

Parameters

Example Response

Code Examples

Why PullAPI

No Browser Needed

Built-in Proxy Rotation

Cached Responses

Pay Per Request

Use Cases

Lead Generation

Business Directory

Local Market Research

Contact Enrichment

Related Scrapers

Google Maps Scraper

Crunchbase Scraper

Product Hunt Scraper

LinkedIn Scraper

Indeed Scraper

Glassdoor Scraper

Ready to scrape Yellow Pages data?