GET/v1/results

Get Results

Retrieve scraped Yelp business listings

Retrieve scraped Yelp business listings including contact information, ratings, reviews, categories, amenities, and location data.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Core Result Fields

id
integer
Unique result identifier
Example: 28426
object
string
Always "result"
Example: result
squid
string
Squid that produced this result
Example: fe5052acadac4487bf5fb1f4afb14200
run
string
Run that produced this result
Example: d6ab6bcf72c94750aacf15e85c42bf62

Business Information

name
string
Name of the business
Example: Joe's Pizza
url
string
Direct Yelp URL to the business listing
Example: https://www.yelp.com/biz/joes-pizza-new-york
categories
string
Comma-separated business categories
Example: Pizza, Italian, Delivery
price
string
Price range indicator ($, $$, $$$, $$$$)
Example: $$
is_claimed
boolean
True if the business profile is claimed by owner
Example: true
is_closed
boolean
True if the business is permanently closed
Example: false

Ratings & Reviews

score
number
Average star rating (1.0-5.0)
Example: 4.5
reviews
integer
Total number of reviews
Example: 1250

Contact Information

phone
string
Business phone number
Example: (212) 555-1234
website
string
Business website URL
Example: https://joespizza.com
email
stringnull
Email address (if collect_contacts enabled)
Example: info@joespizza.com

Location Information

address
string
Business address as listed on Yelp
Example: 7 Carmine St, New York, NY 10014
lat
numbernull
Latitude coordinate
Example: 40.7303
lng
numbernull
Longitude coordinate
Example: -74.0023

Additional Information

amenities
string
Comma-separated amenities offered
Example: Accepts Credit Cards, Delivery, Takeout
website_menu
string
URL to the business's menu page
Example: https://joespizza.com/menu
yelp_menu
stringnull
URL to Yelp-hosted menu section
Example: https://www.yelp.com/menu/joes-pizza

Timestamps

scraping_time
string
When this result was scraped (ISO 8601)
Example: 2025-04-07T06:56:02.016Z

Parameters

squidstring
Required
Hash of the squid to get results from
Example: fe5052acadac4487bf5fb1f4afb14200
runstring
Optional
Hash of a specific run (optional)
Example: d6ab6bcf72c94750aacf15e85c42bf62
pageinteger
Optional
Page number (default: 1)
Example: 1
page_sizeinteger
Optional
Results per page (default: 50, max: 100)
Example: 50
Pro Tip

Pro Tip

Use `score` and `reviews` to filter for highly-rated businesses with significant review counts.
Pro Tip

Pro Tip

Check `is_closed` to filter out permanently closed businesses from your results.
Note

Note

The `email` field is only populated when `collect_contacts` is enabled and an email was found on the business website.