Yelp Search API
With a GET request to our /api/getter/?platform="yelp_search" endpoint you can scrape search results from Yelp in real-time.
Example
To scrape Yelp's search results for the keyword "pizza" in the location "San Francisco, CA, United States", we can use the following command:
1 | |
Query Parameters
As you can see in the example above, our endpoint needs the following query parameters:
Search Query
search
Required
Parameter defines the query you want to search. You can use anything that you would in a regular Yelp search. For e.g. Pizza 90210 or Bi-Rite.
location
Required
Parameter defines the location you want to perform the search query in. This is usually the city name, followed by the state and/or country. But can be anything used on a regular Yelp search. For e.g. San Francisco, CA, United Status or Mitte, Berlin, Germany.
page
Optional
The page number for which you want the results. Default value is 1.
Other Required Parameters
platform
Required
Specifies the scraping engine you wish to invoke. In this case, the value should be yelp_search.
api_key
Required
Your account's token—which can be obtained by signing up here.
Note
The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.
Results
Up to 10 business can be expected in the search results. The response will include the following attirbutes for each business present in the results:
| Attributes Returned | Data Type | Information Represented |
|---|---|---|
| id | string | Yelp's biz id for the listing |
| rank | null/int | Search rank of the business sorted by Yelp's "Recommended" sort. |
| name | string | Name of business listing on Yelp |
| url | string | Link to Yelp listing |
| categories | list | Categories in which the business is listed on Yelp |
| price_range | string | Price range as represented on Yelp |
| rating | float/int | Average rating of the business on Yelp |
| total_reviews | int | Number of reviews the business has |
| neighborhoods | list | Neighborhoods serviced by business |
| phone | string | Business listing's telephone number |
| thumbnail | string | Link to business listing's thumbnail image |
| service_offerings | list | Services offered by the business. For e.g. Delivery, Takeout, Outdoor seating |
| images | list | Links to images of the business |
| address_lines | list | Address of the business |
| latitude | float | Latitude of the business location |
| longitude | float | Longitude of the business location |
Response Example
Here's the response you can expect for the request showcased above:
{
"success": true,
"search": "pizza",
"location": "San Francisco, CA",
"page": 1,
"total_results": 240,
"no_of_pages": 24,
"result_count": 13,
"results": [
{
"id": "h1vxl9HRA-3fz5a_GPVHPA",
"rank": null,
"name": "Chili’s",
"url": "https://www.yelp.com/biz/chilis-san-bruno-2",
"is_sponsored": true,
"categories": [
{
"name": "Tex-Mex",
"url": "https://www.yelp.com/search?find_desc=Tex-Mex&find_loc=San+Francisco%2C+CA"
},
{
"name": "American",
"url": "https://www.yelp.com/search?find_desc=American&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "",
"rating": 0.0,
"total_reviews": 911,
"neighborhoods": [],
"phone": "(650) 952-2692",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/z7QauiZUbH13YbqaF-vvww/ls.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/z7QauiZUbH13YbqaF-vvww/ls.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/3Of7YjWkjyyXJO6Bm1_ddw/ls.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/w0HJAdLq7Hw-vYibEfh7Kw/ls.jpg"
],
"address_lines": [
"899 El Camino Real",
"San Bruno, CA 94066"
],
"latitude": 37.6304480799279,
"longitude": -122.418174894876
},
{
"id": "EOM6CItD6sI5P3a-JV61_Q",
"rank": null,
"name": "Applebee’s Grill + Bar",
"url": "https://www.yelp.com/biz/applebees-grill-bar-san-francisco",
"is_sponsored": true,
"categories": [
{
"name": "Burgers",
"url": "https://www.yelp.com/search?find_desc=Burgers&find_loc=San+Francisco%2C+CA"
},
{
"name": "American",
"url": "https://www.yelp.com/search?find_desc=American&find_loc=San+Francisco%2C+CA"
},
{
"name": "Chicken Wings",
"url": "https://www.yelp.com/search?find_desc=Chicken+Wings&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "",
"rating": 0.0,
"total_reviews": 755,
"neighborhoods": [
"Fisherman's Wharf"
],
"phone": "(415) 749-9025",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/adphoto/e8b7-pZ0yQSjHomhmt492g/ls.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/adphoto/e8b7-pZ0yQSjHomhmt492g/ls.jpg",
"https://s3-media0.fl.yelpcdn.com/adphoto/YQACGMcPRBzK1ODhgr5SaA/ls.jpg",
"https://s3-media0.fl.yelpcdn.com/adphoto/S2lNtfQ05Kb6ZdcJXTBXgQ/ls.jpg"
],
"address_lines": [
"2770 Taylor St",
"San Francisco, CA 94133"
],
"latitude": 37.808211,
"longitude": -122.415805
},
{
"id": "PTFxtXS47ZVRCdZIrEWvGw",
"rank": 1,
"name": "Golden Boy Pizza",
"url": "https://www.yelp.com/biz/golden-boy-pizza-san-francisco",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
},
{
"name": "Italian",
"url": "https://www.yelp.com/search?find_desc=Italian&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$",
"rating": 4.4,
"total_reviews": 4503,
"neighborhoods": [
"North Beach/Telegraph Hill"
],
"phone": "(415) 982-9738",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/YP_8Tm4LXcI2FqTfZuxvAA/348s.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/YP_8Tm4LXcI2FqTfZuxvAA/348s.jpg"
],
"address_lines": [
"542 Green St",
"San Francisco, CA 94133"
],
"latitude": 37.7997956,
"longitude": -122.4080729
},
{
"id": "SUdC4LIL3huirbbBkHrhfw",
"rank": 2,
"name": "The Laundromat",
"url": "https://www.yelp.com/biz/the-laundromat-san-francisco",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
},
{
"name": "Bagels",
"url": "https://www.yelp.com/search?find_desc=Bagels&find_loc=San+Francisco%2C+CA"
},
{
"name": "Beer Bar",
"url": "https://www.yelp.com/search?find_desc=Beer+Bar&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$$",
"rating": 4.6,
"total_reviews": 356,
"neighborhoods": [
"Outer Richmond"
],
"phone": "(415) 379-4340",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/WfzAox82D3iKM2GhUed9Zg/348s.jpg",
"servie_offerings": [],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/WfzAox82D3iKM2GhUed9Zg/348s.jpg"
],
"address_lines": [
"3725 Balboa St",
"San Francisco, CA 94121"
],
"latitude": 37.77542873995666,
"longitude": -122.49884228441336
},
{
"id": "mSMZJj2pFvttWLpcDmgrEA",
"rank": 3,
"name": "Tony’s Pizza Napoletana",
"url": "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
},
{
"name": "Italian",
"url": "https://www.yelp.com/search?find_desc=Italian&find_loc=San+Francisco%2C+CA"
},
{
"name": "Cocktail Bars",
"url": "https://www.yelp.com/search?find_desc=Cocktail+Bars&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$$",
"rating": 4.2,
"total_reviews": 7313,
"neighborhoods": [
"North Beach/Telegraph Hill"
],
"phone": "(415) 835-9888",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/j41n7dUGoDNvGRNuYbrnIQ/348s.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/j41n7dUGoDNvGRNuYbrnIQ/348s.jpg"
],
"address_lines": [
"1570 Stockton St",
"San Francisco, CA 94133"
],
"latitude": 37.8003315377662,
"longitude": -122.409053979377
},
{
"id": "iyo3pjuRb7mTpaDwXnAzuQ",
"rank": 4,
"name": "Square Pie Guys",
"url": "https://www.yelp.com/biz/square-pie-guys-san-francisco",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
},
{
"name": "Chicken Wings",
"url": "https://www.yelp.com/search?find_desc=Chicken+Wings&find_loc=San+Francisco%2C+CA"
},
{
"name": "Salad",
"url": "https://www.yelp.com/search?find_desc=Salad&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$$",
"rating": 4.3,
"total_reviews": 903,
"neighborhoods": [
"SoMa"
],
"phone": "(628) 333-8661",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/usNRsp7QJryycWl3n5GZgQ/348s.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/usNRsp7QJryycWl3n5GZgQ/348s.jpg"
],
"address_lines": [
"1077 Mission St",
"San Francisco, CA 94103"
],
"latitude": 37.77947899999999,
"longitude": -122.4103136
},
{
"id": "75UY4SkdvuhJ-nZTKdVaMw",
"rank": 5,
"name": "Outta Sight Pizza",
"url": "https://www.yelp.com/biz/outta-sight-pizza-san-francisco",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$",
"rating": 4.6,
"total_reviews": 253,
"neighborhoods": [
"Civic Center"
],
"phone": "(415) 829-3108",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/QmWNIf_B_OJk9WCJ1JFdMw/348s.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/QmWNIf_B_OJk9WCJ1JFdMw/348s.jpg"
],
"address_lines": [
"422 Larkin St",
"San Francisco, CA 94102"
],
"latitude": 37.7818216,
"longitude": -122.4171258
},
{
"id": "IxDRIBkKtP-f24sr5zHAhQ",
"rank": 6,
"name": "Pink Onion",
"url": "https://www.yelp.com/biz/pink-onion-san-francisco",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
},
{
"name": "Italian",
"url": "https://www.yelp.com/search?find_desc=Italian&find_loc=San+Francisco%2C+CA"
},
{
"name": "Gastropubs",
"url": "https://www.yelp.com/search?find_desc=Gastropubs&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$$",
"rating": 4.6,
"total_reviews": 1061,
"neighborhoods": [
"Mission"
],
"phone": "(415) 529-2635",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/8GtQUJi_GHlrng88Mv9TOQ/348s.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/8GtQUJi_GHlrng88Mv9TOQ/348s.jpg"
],
"address_lines": [
"64 14th St",
"San Francisco, CA 94103"
],
"latitude": 37.7687808,
"longitude": -122.4148733
},
{
"id": "h1wDLfgEWihWTBJ3z33NLg",
"rank": 7,
"name": "Damn Fine",
"url": "https://www.yelp.com/biz/damn-fine-san-francisco-2",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
},
{
"name": "Wine Bars",
"url": "https://www.yelp.com/search?find_desc=Wine+Bars&find_loc=San+Francisco%2C+CA"
},
{
"name": "Cocktail Bars",
"url": "https://www.yelp.com/search?find_desc=Cocktail+Bars&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$$",
"rating": 4.3,
"total_reviews": 399,
"neighborhoods": [
"Outer Sunset"
],
"phone": "(415) 941-7503",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/u0R-LX4bqQeXmBhKPfTHiQ/348s.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/u0R-LX4bqQeXmBhKPfTHiQ/348s.jpg"
],
"address_lines": [
"3410 Judah St",
"San Francisco, CA 94122"
],
"latitude": 37.76088224819117,
"longitude": -122.4987308
},
{
"id": "QOpqNPKpClL48TVVrYobAw",
"rank": 8,
"name": "Pizzetta 211",
"url": "https://www.yelp.com/biz/pizzetta-211-san-francisco",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
},
{
"name": "Salad",
"url": "https://www.yelp.com/search?find_desc=Salad&find_loc=San+Francisco%2C+CA"
},
{
"name": "Wine Bars",
"url": "https://www.yelp.com/search?find_desc=Wine+Bars&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$$",
"rating": 4.2,
"total_reviews": 1523,
"neighborhoods": [
"Outer Richmond"
],
"phone": "(415) 379-9880",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/1uWcAal9dbi2iOvULeLI4w/348s.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/1uWcAal9dbi2iOvULeLI4w/348s.jpg"
],
"address_lines": [
"211 23rd Ave",
"San Francisco, CA 94121"
],
"latitude": 37.783684,
"longitude": -122.482974
},
{
"id": "wEzg_lla5jqAzIXokYnZJA",
"rank": 9,
"name": "That’s Amore Woodfire Pizza",
"url": "https://www.yelp.com/biz/thats-amore-woodfire-pizza-san-francisco",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
},
{
"name": "Beer, Wine & Spirits",
"url": "https://www.yelp.com/search?find_desc=Beer%2C+Wine+%26+Spirits&find_loc=San+Francisco%2C+CA"
},
{
"name": "Italian",
"url": "https://www.yelp.com/search?find_desc=Italian&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$$",
"rating": 4.6,
"total_reviews": 222,
"neighborhoods": [
"Ingleside Terraces"
],
"phone": "(415) 347-7331",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/eEg-2sZMwcT1FcE43l7j5w/348s.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/eEg-2sZMwcT1FcE43l7j5w/348s.jpg"
],
"address_lines": [
"1901 Ocean Ave",
"San Francisco, CA 94127"
],
"latitude": 37.72512769107495,
"longitude": -122.4624309873901
},
{
"id": "OlIEWBUz426ev_UPZBb20Q",
"rank": 10,
"name": "Gioia Pizzeria",
"url": "https://www.yelp.com/biz/gioia-pizzeria-san-francisco-2",
"is_sponsored": false,
"categories": [
{
"name": "Pizza",
"url": "https://www.yelp.com/search?find_desc=Pizza&find_loc=San+Francisco%2C+CA"
},
{
"name": "Desserts",
"url": "https://www.yelp.com/search?find_desc=Desserts&find_loc=San+Francisco%2C+CA"
},
{
"name": "American",
"url": "https://www.yelp.com/search?find_desc=American&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "$",
"rating": 4.3,
"total_reviews": 378,
"neighborhoods": [
"Hayes Valley"
],
"phone": "(415) 872-9427",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/8K29RRcHE176c8z8bLSvFg/348s.jpg",
"servie_offerings": [
"Outdoor seating",
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/8K29RRcHE176c8z8bLSvFg/348s.jpg"
],
"address_lines": [
"579 Hayes St",
"San Francisco, CA 94102"
],
"latitude": 37.7764197139406,
"longitude": -122.425847053528
},
{
"id": "X9WCWO4eikSkhuy6y2VMcA",
"rank": null,
"name": "Burger King",
"url": "https://www.yelp.com/biz/burger-king-san-francisco-9",
"is_sponsored": true,
"categories": [
{
"name": "Fast Food",
"url": "https://www.yelp.com/search?find_desc=Fast+Food&find_loc=San+Francisco%2C+CA"
},
{
"name": "Burgers",
"url": "https://www.yelp.com/search?find_desc=Burgers&find_loc=San+Francisco%2C+CA"
},
{
"name": "Chicken Shop",
"url": "https://www.yelp.com/search?find_desc=Chicken+Shop&find_loc=San+Francisco%2C+CA"
}
],
"price_range": "",
"rating": 0.0,
"total_reviews": 142,
"neighborhoods": [
"Fillmore"
],
"phone": "(415) 775-4211",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/baEpLhjt73MzWouJNaMmcA/348s.jpg",
"servie_offerings": [
"Delivery",
"Takeout"
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/baEpLhjt73MzWouJNaMmcA/348s.jpg"
],
"address_lines": [
"819 Van Ness Ave",
"San Francisco, CA 94109"
],
"latitude": 37.7831366,
"longitude": -122.4212139
}
],
"meta_data": {},
"remaining_credits": 595202
}
Request Cost
1 credit per request.
Support
If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com