Yellow Pages Place API

GET   /api/v1/search?engine=yellowpages_place

The Yellow Pages Place API returns a Yellow Pages business page as JSON: the name, categories, phone numbers, address and coordinates, the website the page links, email, opening hours for each day of the week as the page shows them, Yellow Pages and Tripadvisor ratings, and badges such as years in business, claimed, paid and YP Preferred. It also returns the More Info details the business lists (services, brands, payment methods, languages, neighborhoods, other names, history and other information such as parking or accepted insurance), its logo and the photos shown on the page, and the ten most recent reviews with their per-aspect stars and the business's reply.

Pass the number that ends a business page URL as place_id. Fields the business does not list are left out, and boolean fields appear only when true. A place_id Yellow Pages has no business for returns error instead of place_result, with HTTP 200, and counts as a search. When a business has more than ten reviews, reviews_pagination gives their total and the Yellow Pages page with the next ten.

API Parameters

Search Query

  • Name
    place_id
    Required
    Required
    Description

    Numeric id of the Yellow Pages business: the number that ends its page URL, such as 531159833 in yellowpages.com/new-york-ny/mip/lombardis-531159833. An id Yellow Pages has no business for returns HTTP 200 with an error field and counts as a search.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to yellowpages_place.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response

A restaurant with its hours, Yellow Pages and Tripadvisor ratings, More Info details, photos and its first ten reviews.

GET
https://www.searchapi.io/api/v1/search?engine=yellowpages_place&place_id=531159833
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yellowpages_place",
  "place_id": "531159833"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_7VCZWFiSw5ozzUBo7ySNNln8",
    "status": "Success",
    "created_at": "2026-11-12T14:42:27Z",
    "request_time_taken": 1.13,
    "parsing_time_taken": 0.13,
    "total_time_taken": 1.26,
    "request_url": "https://www.yellowpages.com/nationwide/mip/x-531159833",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_7VCZWFiSw5ozzUBo7ySNNln8.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_7VCZWFiSw5ozzUBo7ySNNln8"
  },
  "search_parameters": {
    "engine": "yellowpages_place",
    "place_id": "531159833"
  },
  "place_result": {
    "place_id": "531159833",
    "title": "Lombardi's",
    "link": "https://www.yellowpages.com/new-york-ny/mip/lombardis-531159833",
    "type": "Restaurant",
    "categories": [
      {
        "title": "Pizza",
        "link": "https://www.yellowpages.com/new-york-ny/pizza"
      },
      "..."
    ],
    "rating": 4.5,
    "reviews": 11,
    "web_reviews": [
      {
        "title": "Tripadvisor",
        "link": "https://www.tripadvisor.com/Restaurant_Review-g60763-d457790-Reviews-Lombardi_s-New_York_City_New_Yo...",
        "rating": 4.0,
        "reviews": 4921
      },
      "..."
    ],
    "phone": "(212) 941-7994",
    "extra_phones": [
      {
        "title": "Fax",
        "phone": "(212) 941-4159"
      },
      "..."
    ],
    "address": "32 Spring St, New York, NY 10012",
    "street_address": "32 Spring St",
    "city": "New York",
    "state": "NY",
    "postal_code": "10012",
    "gps_coordinates": {
      "latitude": 40.721615,
      "longitude": -73.9958
    },
    "website": "http://www.firstpizza.com",
    "email": "lombardis@yahoo.com",
    "open_state": "closed now",
    "hours": "Today: 11:30 am - 11:00 pm",
    "open_hours": {
      "monday": "11:30 am - 11:00 pm",
      "tuesday": "11:30 am - 11:00 pm",
      "wednesday": "11:30 am - 11:00 pm",
      "thursday": "11:30 am - 11:00 pm",
      "friday": "11:30 am - 11:30 pm",
      "saturday": "11:30 am - 11:30 pm",
      "sunday": "11:30 am - 11:00 pm"
    },
    "years_in_business": 129,
    "amenities": [
      "Good for families"
    ],
    "payment_methods": [
      "cash only"
    ],
    "neighborhoods": [
      "Downtown Manhattan",
      "Nolita"
    ],
    "also_known_as": [
      "Lombardi's Delano"
    ],
    "other_links": [
      "http://www.firstpizza.com",
      "https://www.firstpizza.com"
    ],
    "other_information": [
      {
        "title": "Parking",
        "value": "Lot, On Site"
      },
      "..."
    ],
    "thumbnail": "https://i1.ypcdn.com/blob/3599daa7f3a6ab5bd6c710b47c83c08be6bf8802_150x150_crop.jpg",
    "images": [
      {
        "original": "https://i1.ypcdn.com/blob/3599daa7f3a6ab5bd6c710b47c83c08be6bf8802",
        "thumbnail": "https://i1.ypcdn.com/blob/3599daa7f3a6ab5bd6c710b47c83c08be6bf8802_228x168_crop.jpg",
        "source": "Yellow Pages"
      },
      "..."
    ],
    "total_images": 8
  },
  "reviews": [
    {
      "position": 1,
      "review_id": "d99a1a8b-c872-4d10-bd66-0677969c68a9",
      "user": {
        "name": "Sarah G.",
        "link": "https://www.yellowpages.com/user/527585978/reviews",
        "thumbnail": "https://i3.ypcdn.com/blob/6988bbe43b248b367379c53094409b48e7db9796_40x40_crop.jpg"
      },
      "iso_date": "2016-04-01",
      "rating": 5.0,
      "subratings": [
        {
          "text": "Atmosphere",
          "value": 5.0
        },
        "..."
      ],
      "text": "We had to wait a little bit… But it was worth the wait! You feel like you're in Italy inside the restaurant. The pizza was delicious!!!!",
      "votes": 0
    },
    "..."
  ],
  "reviews_pagination": {
    "current": 1,
    "total": 11,
    "next": "https://www.yellowpages.com/new-york-ny/mip/lombardis-531159833?page=2"
  }
}

Badges and More Info

Badges and More Info

A claimed, YP Preferred business with years in business and years with Yellow Pages, a slogan and special offer, and More Info rows such as services, ownership, languages, free estimates and social links.

GET
https://www.searchapi.io/api/v1/search?engine=yellowpages_place&place_id=4718716
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yellowpages_place",
  "place_id": "4718716"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_PgQfhvWyNZYAXc1z49jk3n7k",
    "status": "Success",
    "created_at": "2026-11-12T14:42:41Z",
    "request_time_taken": 1.07,
    "parsing_time_taken": 0.09,
    "total_time_taken": 1.16,
    "request_url": "https://www.yellowpages.com/nationwide/mip/x-4718716",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_PgQfhvWyNZYAXc1z49jk3n7k.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_PgQfhvWyNZYAXc1z49jk3n7k"
  },
  "search_parameters": {
    "engine": "yellowpages_place",
    "place_id": "4718716"
  },
  "place_result": {
    "place_id": "4718716",
    "title": "Wells Plumbing & Heating",
    "link": "https://www.yellowpages.com/chicago-il/mip/wells-plumbing-heating-4718716",
    "type": "LocalBusiness",
    "categories": [
      {
        "title": "Heating Equipment & Systems",
        "link": "https://www.yellowpages.com/chicago-il/heating-equipment-systems"
      },
      "..."
    ],
    "rating": 5.0,
    "reviews": 1,
    "phone": "(312) 878-8062",
    "address": "916 West 21st Street, Chicago, IL 60608",
    "street_address": "916 West 21st Street",
    "city": "Chicago",
    "state": "IL",
    "postal_code": "60608",
    "gps_coordinates": {
      "latitude": 41.854076,
      "longitude": -87.64871
    },
    "website": "https://shop.wellsplumbing.com/locations.HTML",
    "open_state": "open now",
    "hours": "Today: 6:30 am - 4:30 pm",
    "open_hours": {
      "monday": "6:30 am - 4:30 pm",
      "tuesday": "6:30 am - 4:30 pm",
      "wednesday": "6:30 am - 4:30 pm",
      "thursday": "6:30 am - 4:30 pm",
      "friday": "6:30 am - 4:30 pm",
      "saturday": "7:00 am - 12:00 pm",
      "sunday": "Closed"
    },
    "years_in_business": 19,
    "years_with_yp": 8,
    "is_claimed": true,
    "is_paid_listing": true,
    "is_preferred": true,
    "slogan": "Leading importer & distributor of a broad line of plumbing and heating products!",
    "special_offer": {
      "text": "Call Today !"
    },
    "description": "Wells’ mission is to provide the industry and profession of residential and commercial improvement and construction with competitive, first-rate products, services, and technological solutions through thorough market research and commitment to global view of the development of the industry. Since its establishment and operation in 2002, wells has successfully built up an extensive distribution network throughout the Chicago metropolitan area, experiencing a fast growth in revenue.",
    "services": [
      "Gas Line Repair/Replacement",
      "Water Heater Repair/Replacement",
      "General Plumbing",
      "Faucet Repair/Replacement"
    ],
    "payment_methods": [
      "mastercard"
    ],
    "languages": [
      "Chinese",
      "English",
      "Polish",
      "Spanish"
    ],
    "ownership": "Locally Owned",
    "has_free_estimates": true,
    "neighborhoods": [
      "West Side",
      "Pilsen"
    ],
    "other_links": [
      "https://shop.wellsplumbing.com/locations.HTML"
    ],
    "social_links": [
      "http://www.facebook.com/platform"
    ],
    "thumbnail": "https://i3.ypcdn.com/blob/3dba1c41addf7a5460c08bfab62e521a4d648c48_150x150_crop.jpg",
    "images": [
      {
        "original": "https://i3.ypcdn.com/blob/3dba1c41addf7a5460c08bfab62e521a4d648c48",
        "thumbnail": "https://i3.ypcdn.com/blob/3dba1c41addf7a5460c08bfab62e521a4d648c48_228x168_crop.jpg",
        "source": "Yellow Pages"
      },
      "..."
    ],
    "total_images": 3
  }
}

Opening Hours

Opening Hours

open_hours gives each day as the page's Hours table shows it, with both ranges of a day that closes in the afternoon, Closed days, and Open 24 Hours. A business that writes its hours as text instead gets open_hours_text.

GET
https://www.searchapi.io/api/v1/search?engine=yellowpages_place&place_id=14730320
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yellowpages_place",
  "place_id": "14730320"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_kUYtq2hPPx2iPLyaz34A70fW",
    "status": "Success",
    "created_at": "2026-11-12T18:10:34Z",
    "request_time_taken": 1.08,
    "parsing_time_taken": 0.13,
    "total_time_taken": 1.21,
    "request_url": "https://www.yellowpages.com/nationwide/mip/x-14730320",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_kUYtq2hPPx2iPLyaz34A70fW.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_kUYtq2hPPx2iPLyaz34A70fW"
  },
  "search_parameters": {
    "engine": "yellowpages_place",
    "place_id": "14730320"
  },
  "place_result": {
    "place_id": "14730320",
    "title": "Dragon Well",
    "link": "https://www.yellowpages.com/san-francisco-ca/mip/dragon-well-14730320",
    "type": "Restaurant",
    "categories": [
      {
        "title": "Chinese Restaurants",
        "link": "https://www.yellowpages.com/san-francisco-ca/chinese-restaurants"
      },
      "..."
    ],
    "rating": 3.0,
    "reviews": 2,
    "web_reviews": [
      {
        "title": "Tripadvisor",
        "link": "https://www.tripadvisor.com/Restaurant_Review-g60713-d370410-Reviews-Dragon_Well-San_Francisco_Calif...",
        "rating": 4.5,
        "reviews": 191
      },
      "..."
    ],
    "phone": "(415) 474-6888",
    "address": "2142 Chestnut St, San Francisco, CA 94123",
    "street_address": "2142 Chestnut St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94123",
    "gps_coordinates": {
      "latitude": 37.800636,
      "longitude": -122.438736
    },
    "website": "http://www.dragonwell.com/?y_source=1_MzAwNjEwODYtNTUzLWxvY2F0aW9uLndlYnNpdGU%3D",
    "email": "info@dragonwell.com",
    "open_state": "closed now",
    "hours": "Today: 11:30 am - 3:00 pm, 5:00 pm - 10:00 pm",
    "open_hours": {
      "monday": "Closed",
      "tuesday": "Closed",
      "wednesday": "11:30 am - 3:00 pm, 5:00 pm - 10:00 pm",
      "thursday": "11:30 am - 3:00 pm, 5:00 pm - 10:00 pm",
      "friday": "11:30 am - 3:00 pm, 5:00 pm - 10:00 pm",
      "saturday": "11:30 am - 3:00 pm, 5:00 pm - 10:00 pm",
      "sunday": "11:30 am - 3:00 pm, 5:00 pm - 10:00 pm"
    },
    "years_in_business": 28,
    "special_offer": {
      "text": "We have delicious gluten-free options!"
    },
    "description": "Our aim today is the same as when we opened Dragon Well in 1998: to serve delicious and healthy Chinese food with warm, friendly service.",
    "payment_methods": [
      "master card",
      "visa",
      "amex",
      "cash",
      "check",
      "debit",
      "diners club",
      "discover"
    ],
    "neighborhoods": [
      "Northwest San Francisco",
      "Marina District"
    ],
    "other_links": [
      "http://www.dragonwell.com/?y_source=1_MzAwNjEwODYtNTUzLWxvY2F0aW9uLndlYnNpdGU%3D",
      "..."
    ],
    "other_information": [
      {
        "title": "Cuisines",
        "value": "Pizza, Family Style, Chinese, Asian"
      },
      "..."
    ],
    "thumbnail": "https://i2.ypcdn.com/blob/b6a607b84d5862e28bcc2301345950d7c33154e3_150x150_crop.jpg",
    "images": [
      {
        "original": "https://i2.ypcdn.com/blob/b6a607b84d5862e28bcc2301345950d7c33154e3",
        "thumbnail": "https://i2.ypcdn.com/blob/b6a607b84d5862e28bcc2301345950d7c33154e3_228x168_crop.jpg",
        "source": "Yellow Pages"
      },
      "..."
    ],
    "total_images": 7
  }
}

Reviews

Reviews

Each review carries its rating, title, text, helpful votes and date as iso_date, with is_edited when the reviewer changed it and response when the business replied. reviews_pagination.total counts every review of the business.

GET
https://www.searchapi.io/api/v1/search?engine=yellowpages_place&place_id=466824736
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yellowpages_place",
  "place_id": "466824736"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_fGxDmgHzEkPFH5EtmriguUxp",
    "status": "Success",
    "created_at": "2026-11-12T18:10:35Z",
    "request_time_taken": 0.95,
    "parsing_time_taken": 0.0,
    "total_time_taken": 0.95,
    "request_url": "https://www.yellowpages.com/nationwide/mip/x-466824736",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_fGxDmgHzEkPFH5EtmriguUxp.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_fGxDmgHzEkPFH5EtmriguUxp"
  },
  "search_parameters": {
    "engine": "yellowpages_place",
    "place_id": "466824736"
  },
  "reviews": [
    {
      "position": 1,
      "review_id": "b6de583d-9f6f-4b9e-980e-a24f49a7ea62",
      "user": {
        "name": "Emmy M.",
        "link": "https://www.yellowpages.com/user/573014579/reviews"
      },
      "iso_date": "2017-12-16",
      "rating": 5.0,
      "text": "I wanted to change my dogs' vet since I felt our previous vet was always trying to get us to spend more money there than necessary, BUT Dr. Dertinger was great! She spent time checking our dog, went over the vaccinations she thought we needed and were optional. She took her time to talk and didn't seemed rushed at all. I liked the front desk's service and of course, Dr. Dertinger!",
      "votes": 0,
      "response": {
        "text": "Emmy, Thank you for sharing your wonderful and touching review with us. We love reading reviews like yours because it truly goes to show that our staff goes above and beyond to ensure that your dog’s needs are met. We will be sure to pass this kind review to Dr. Dertinger on your behalf. We hope all is well, please do not be afraid to give us a call if there is anything else we can do for you!",
        "iso_date": "2017-12-18"
      }
    },
    "..."
  ]
}