Yelp Place Scraper API

When a Yelp place search contains place results, they are parsed and exist within the place_results array in the JSON output. Place results can contain name, review, rating, address, country, website, price, phone, categories and more.

API Parameters

Search Query

place_id

Optional

Parameter defines the Yelp ID of a place. Each place has two unique IDs (e.g. ED7A7vDdg8yLNKJTSVHHmg and arabica-brooklyn) and you can use either of them as a value of the place_id. To extract the IDs of a place you can use our Yelp Search API.

Localization

yelp_domain

Optional

Parameter defines the Yelp domain to use. It defaults to yelp.com. Head to the Yelp domains for a full list of supported Yelp domains.

Serpapi Parameters

engine

Required

Set parameter to yelp_place to use the Yelp place API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Yelp place results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

JSON structure overview

{
  ...
  "place_results": {
    "name": "String - Name of the place (Ex: '% Arabica')",
    "about": "String - Extra Information about the place ('Maman, a café and bakery in SoHo, serves family-inspired recipes from the South of France.')",
    "reviews": "Integer - Number of reviews of the place (Ex: 229)",
    "rating": "Float - Rating of the place (Ex: 4.4)",
    "is_claimable": "Boolean - Whether the page of the place is claimable or not. In some cases, a place is still claimable although it is claimed. (Ex: false)",
    "is_claimed": "Boolean - Whether the page of the place is claimed or not. (Ex: true)",
    "price": "String - Expensiveness expressed in currency (Ex: '$$')",
    "categories": [
      {
        "title": "String - Category title (Ex: 'Coffee & Tea')",
        "link": "String - Yelp link to category"
      },
      ...
    ],
    "images": [
      "String - Link to an image of the place",
      ...
    ],
    "see_all_images_link": "String - Yelp link to all images of the place",
    "website": "String - Website of the place",
    "phone": "String - Phone number of the place",
    "address": "String - Address of the place",
    "directions": "String - Yelp Map directions link to the place",
    "history": {
      "description": "String - Description about the history of the place (Ex: 'In 2021, Maman founders released the highly anticipated cookbook')",
      "established": "String - Establishment date of the place (Ex: '2014')"
    },
    "popular_items": [
      {
        "title": "String - Name of a popular dish or drink of the place (Ex: 'Spanish Lattes')",
        "photos": "Integer - Number of photos of the popular item (Ex: 71)",
        "reviews": "Integer - Number of reviews made to a popular item (Ex: 88)",
        "thumbnail": "String - Link to the thumbnail of a popular item"
      },
      ...
    ]
    "review_highlights": [
      {
        "highlight": "String - Highlighted word in a review (Ex 'Kyoto Latte')",
        "review": "String - Entire review text (Ex: 'Kyoto Latte was refreshing.')",
        "review_count": "Integer - Number of reviews with the same highlighted word (Ex: 27)",
        "author": "String - Author of the Review",
        "thumbnail": "String - Link to thumbnail of a review",
        "link": "String - Yelp Link to all reviews with the highlighted word"
      },
      ...
    ],
    "website_menu": "String - Yelp redirection link to the menu on the website of the place",
    "full_menu": "String - Yelp link to the menu of the place",
    "business_map": "String - Link to the image of Google Maps marking the place",
    "cross_streets": "String - Cross streets where the place is located (Ex: 'Grand St & Cleveland Pl')",
    "neighborhoods": [
      "String - Neighborhoods nearby the place (Ex: 'Brooklyn Heights')",
    ],
    "country": "String - Two letter country code of the place's location (Ex: 'US')",
    "operation_hours": {
      "last_update": "String - Information about when the operational hours were updated (Ex: 'Hours updated 1 month ago')",
      "hours": [
        {
          "day": "String - Day at the operational hours table (Ex: 'Mon')",
          "hours": "String - Operational hours of the day (Ex: '8:00 AM - 6:00 PM')",
          "currently_open": "Boolean - If the place is open on the day or not (Ex: true)"
        },
        ...
      ]
    },
    "health_provider": {
      "name": "String - Name of the health provider company of the place (Ex: 'Hazel Analytics')",
      "link": "String - Link to the website of the health provider company",
      "score": "String - Score given by the health provider company (Ex: 'A')"
    },
    "features": [
      {
        "title": "String - Title of the feature of the place (Ex: 'Offers Takeout')",
        "is_active": "Boolean - Whether or not the feature is active (Ex: true)"
      },
      ...
    ],
    "community_questions": [
      {
        "question": "String - Question from the community about the place (Ex: 'Do they sell whole bean coffee to go?')",
        "answer": "String - Answer to the question from the community (Ex: 'Yes')",
        "author": "String - Author of the question",
        "date": "String - Date of the question (Ex: '2 years ago')",
        "helpful_vote_count": "Integer - How many people vote this question to be helpful (Ex: 2)",
        "extra_link": {
          "text": "String - Text of the extra button about question or answer (Ex: 'See question details')",
          "link": "String - Yelp link of the extra button about question or answer"
        },
      },
      ...
    ],
    "see_more_questions_link": "String - Yelp link to more community questions about the place",
    "recommended_reviews": [
      {
        "author": "String - Author of the recommended review",
        "review": "String - Recommended review text (Ex: 'Came here on a Sunday morning around 10am. It was nice.')",
        "rating": "Integer - Rating of the recommended review",
      },
      ...
    ],
    "not_recommended_reviews_link": "String - Yelp link to not recommended reviews",
    "number_of_not_recommended_reviews": "String - Number of not recommended reviews (Ex: 9)",
    "faqs": [
      {
        "question": "String - Frequently asked question (Ex: 'Does % Arabica have outdoor seating?')",
        "answer": "String - Answer to the frequently asked question (Ex: 'Yes, % Arabica has outdoor seating.')"
      },
      ...
    ],
  }
}

API Examples

Place results overview

Place results overview

JSON Example

{
  "search_metadata": {
    "id": "64df7e1f40c4a95767021531",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/686f749c62237361/64df7e1f40c4a95767021531.json",
    "created_at": "2023-08-18 14:20:15 UTC",
    "processed_at": "2023-08-18 14:20:15 UTC",
    "yelp_place_url": "https://www.yelp.com/biz/maman-new-york-22",
    "raw_html_file": "https://serpapi.com/searches/686f749c62237361/64df7e1f40c4a95767021531.html",
    "total_time_taken": 1.33
  },
  "search_parameters": {
    "engine": "yelp_place",
    "place_id": "maman-new-york-22"
  },
  "place_results": {
    "name": "Maman",
    "about": "Maman, a café and bakery in SoHo, serves family-inspired recipes from the South of France and North America, bringing to life childhood favorites both savory and sweet. The inspiring, ever-evolving menu features dishes created from the highest quality, locally-sourced ingredients and changes every day.",
    "reviews": 760,
    "rating": 3.9,
    "is_claimed": true,
    "price": "$$",
    "categories": [
      {
        "title": "Cafes",
        "link": "https://www.yelp.com/search?find_desc=Cafes&find_loc=New+York%2C+NY"
      },
      {
        "title": "Bakeries",
        "link": "https://www.yelp.com/search?find_desc=Bakeries&find_loc=New+York%2C+NY"
      },
      {
        "title": "Breakfast & Brunch",
        "link": "https://www.yelp.com/search?find_desc=Breakfast+%26+Brunch&find_loc=New+York%2C+NY"
      },
      {
        "title": "Restaurants",
        "link": "https://www.yelp.com/c/nyc/restaurants"
      },
      {
        "title": "Food",
        "link": "https://www.yelp.com/c/nyc/food"
      }
    ],
    "images": [
      "https://s3-media0.fl.yelpcdn.com/bphoto/dCIj5bWCOM_PORWLqQB4ow/l.jpg",
      "https://s3-media0.fl.yelpcdn.com/bphoto/3JRNOL1twgmq5s7e6kU5cQ/l.jpg",
      "https://s3-media0.fl.yelpcdn.com/bphoto/nUj5B96Xh73Y2aGmuvDr6Q/l.jpg",
      ...
    ],
    "see_all_images_link": "https://www.yelp.com/biz_photos/DE0ROwygh-86i4s-WLp8wQ",
    "website": "https://www.mamannyc.com",
    "phone": "(212) 226-0700",
    "address": "239 Centre St New York, NY 10013",
    "directions": "https://www.yelp.com/map/DE0ROwygh-86i4s-WLp8wQ",
    "history": {
      "description": "maman is a french café and lifestyle brand, offering baked goods, coffee, fresh breakfast, and lunch options, as well as hosting intimate events and brand partnerships. in 2021, maman founders released the highly anticipated maman: the cookbook. {please note we are laptop free environment}",
      "established": "2014"
    },
    "popular_items": [
      {
        "title": "Almond Croissant",
        "description": "a flakey croissant with a sweet almond filling and topped with almonds",
        "photos": 14,
        "reviews": 25,
        "price": "$5.00",
        "extracted_price": 5,
        "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/hSF_ejYc-oL7hxgpyIwWCA/258s.jpg"
      },
      {
        "title": "Maman's Breakfast Sandwich",
        "description": "avocado, roasted tomatoes, caramelized onions, bacon & a sunny egg on a cornmeal bun",
        "photos": 12,
        "reviews": 20,
        "price": "$13.50",
        "extracted_price": 13.5,
        "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/bQvWisoh1Sr4i8QOz1BZnQ/258s.jpg"
      },
      {
        "title": "Pistachio Croissant",
        "description": "a fun twist on the classic chocolate croissant, our pistachio chocolate croissant is made with delicious custard cream & chocolate on the inside and topped with crushed pistachios",
        "photos": 18,
        "reviews": 18,
        "price": "$5.50",
        "extracted_price": 5.5,
        "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/5lYKDkFC9mGdXyc6hrvftA/258s.jpg"
      },
      ...
    ],
    "review_highlights": [
      {
        "highlight": "almond croissant",
        "review": "We also got an almond croissant, a pistachio chocolate croissant, and a few of their chocolate chip cookies.",
        "review_count": 25,
        "author": "Kenneth L.",
        "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/gQ-n8zSqH4I3dzAzPByV0Q/60s.jpg",
        "link": "https://www.yelp.com/biz/maman-new-york-22?hrid=BmAy7YQQW_AOR0_pHZAm_Q&rh_ident=almond-croissant&rh_type=menu"
      },
      {
        "highlight": "breakfast sandwich",
        "review": "I really enjoyed the breakfast sandwich and my latte, which I was able to get in a to-go cup on my way out.",
        "review_count": 20,
        "author": "Emily T.",
        "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/HtERpFVJduK56L2Yq1IWVg/60s.jpg",
        "link": "https://www.yelp.com/biz/maman-new-york-22?hrid=TTi-o8SD9sJViMIdLsqwnA&rh_ident=mamans-breakfast-sandwich&rh_type=menu"
      },
      {
        "highlight": "nutty chocolate chip",
        "review": "While I was told the nutty chocolate chip was the best - I actually preferred the white chocolate pretzel.",
        "review_count": 8,
        "author": "Emma G.",
        "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/EpNqzh2fngEJh4K5FEkBvA/60s.jpg",
        "link": "https://www.yelp.com/biz/maman-new-york-22?hrid=rL-5UyLVKhBf9zq1IORGcA&rh_ident=nutty_chocolate_chip&rh_type=phrase"
      },
      ...
    ],
    "website_menu": "https://www.yelp.com/biz_redir?cachebuster=1692368419&s=7918844e7e65e5f27f63656f70b15c5cb90cf785be256077f78f90f047807214&src_bizid=DE0ROwygh-86i4s-WLp8wQ&url=http%3A%2F%2Fwww.mamannyc.com&website_link_type=menu",
    "full_menu": "https://www.yelp.com/menu/maman-new-york-22",
    "business_map": "https://maps.googleapis.com/maps/api/staticmap?size=315x180&sensor=false&client=gme-yelp&language=en&scale=1&zoom=15&center=40.720279%2C-73.998406&markers=scale%3A1%7Cicon%3Ahttps%3A%2F%2Fyelp-images.s3.amazonaws.com%2Fassets%2Fmap-markers%2Fannotation_32x43.png%7C40.720279%2C-73.998406&signature=Lndr6ORt30dMNbGsVbB055MOLf0=",
    "cross_streets": "Grand St & Cleveland Pl",
    "neighborhoods": [
      "Little Italy",
      "SoHo"
    ],
    "country": "US",
    "operation_hours": {
      "last_update": "Hours updated 3 months ago",
      "hours": [
        {
          "day": "Mon",
          "hours": "7:30 AM - 6:00 PM"
        },
        {
          "day": "Tue",
          "hours": "7:30 AM - 6:00 PM"
        },
        {
          "day": "Wed",
          "hours": "7:30 AM - 6:00 PM"
        },
        ...
      ]
    },
    "health_provider": {
      "name": "Hazel Analytics",
      "link": "https://hazelanalytics.com/",
      "score": "A"
    },
    "features": [
      {
        "title": "Offers Delivery",
        "is_active": true
      },
      {
        "title": "Offers Takeout",
        "is_active": true
      },
      {
        "title": "No Reservations",
        "is_active": false
      },
      ...
    ],
    "community_questions": [
      {
        "question": "Do you need reservations?",
        "answer": "No you don't",
        "author": "Stephanie G.",
        "date": "1 year ago",
        "extra_link": {
          "text": "See 2 more answers",
          "link": "https://www.yelp.com/questions/DE0ROwygh-86i4s-WLp8wQ/RTUf-GDZLxOXr6f-xggXcg"
        }
      }
    ],
    "see_more_questions_link": "https://www.yelp.com/questions/DE0ROwygh-86i4s-WLp8wQ",
    "recommended_reviews": [
      {
        "author": "Karan L.",
        "review": "Tis coffee shop certainly delivers when it comes to having an aesthetic. The flowers and the decor are absolutely on point. If you want to show your friends what a stunning nyc cafe looks like, this is the place.\n\nThe service was great and also provided a number of recs! My friends were new to town, the servers pointed out a number of great places for us to visit, many of which I have never heard of (despite living here for a little over a year now).\n\nThe seasonal drinks also were quite pretty. I was very underwhelmed by the pastries I ordered. They seemed quite dry and not so fresh when I had ordered. Even though there is a huge selection, and I would highly recommend this cafe, the pastries were not something I would purchase again.",
        "rating": 4
      },
      {
        "author": "Olivia L.",
        "review": "This is a the perfect coffee shop in Soho if you're looking for somewhere cute and aesthetic. Like all Maman stores, it's decorated with blue and white porcelain and lots of plants. \n\nI just had a latte to go at this location. It was $4.50 for a medium iced latte and I added simple syrup for $0.50. I find it a bit ridiculous that they charge for the simple syrup when it's usually complimentary at all other coffee shops. The latte wasn't anything special, but does the job. \n\nThe place was crowded on a Saturday afternoon as expected, so it would be difficult to get a table. It's a nice coffee shop to catch up with friends due to the aesthetic, but the coffee isn't anything special.\n\nPro tip--if you have the Seated app, you can reserve yourself as walk-in right before you go and submit your receipt and get like 20% back. I did this and got $1 off my latte :) you can use my referral code for some extra savings (olivia1343)",
        "rating": 4
      },
      {
        "author": "Chris W.",
        "review": "Cute coffee shop in the mists of SoHo. Didn't get to explore a lot of SoHo much but there was good oat milk latte, pistachio croissant, and an avocado egg bacon breakfast sandwich \n\nService was quick and they were really friendly.",
        "rating": 4
      },
      ...
    ],
    "not_recommended_reviews_link": "https://www.yelp.com/not_recommended_reviews/DE0ROwygh-86i4s-WLp8wQ",
    "number_of_not_recommended_reviews": 42,
    "faqs": [
      {
        "question": "Does Maman have outdoor seating?",
        "answer": "Yes, Maman has outdoor seating."
      },
      {
        "question": "Is Maman currently offering delivery or takeout?",
        "answer": "Yes, Maman offers both delivery and takeout."
      },
      {
        "question": "What forms of payment are accepted?",
        "answer": "Maman accepts credit cards."
      },
      ...
    ]
  }
}