Business Data API: Yelp Overview
This API currently provides business reviews and business details publicly shared on Yelp. More capabilities to obtain data from Yelp will be released in the nearest future.
Using Yelp Search you can obtain data on businesses listed on the Yelp platform, including business locations, contact details, rating, and business offerings.
Using Yelp Reviews you can get reviews’ count, time of submission, rating details, reviews’ content, images published by the reviewer, reviewer profile information, and more. You can sort the results by newest, oldest, the highest rating, or reviews received from elite Yelp users.
Setting a task
Note that in order to receive Yelp reviews, you can use either the conventional
keyword, or a unique Yelp identifier –
alias. Every Yelp business has a unique alias, such as
the-broome-nyc-new-york, that identifies a given local establishment. You can get this identifier by setting a separate task to Yelp Search. The results of the set Yelp Search task will contain aliases indicated for all listed businesses.
alias parameter can be found on the Yelp website as a part of the URL pointing to a specific local establishment.
For example, here is the URL of InterContinental Singapore on Yelp:
alias of this hotel is
We emulate set parameters with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results by accessing the
check_url in the Incognito mode to make sure the received data is entirely relevant. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned results.
All Business Data API endpoints support the Standard method of data retrieval. It requires making separate POST and GET requests. Using this method, you can retrieve the results after our system collects them.
Alternatively, you can specify
postback_url when setting a task, and we will notify you on completion of tasks or send them to you respectively.
If you do not specify
postback_url, you can receive the list of
id for all completed tasks using the ‘Tasks Ready’ endpoint. It is designed to provide you with the list of completed tasks, which haven’t been collected yet. Then, you can retrieve the results using the ‘Task GET’ endpoint.
Learn more about task completion and obtaining a list of completed tasks in this help center article.
You can send up to 2000 API calls per minute, with each POST call containing no more than 100 tasks. Contact us if you would like to raise the limit.
Priorities and cost
Business Data API has two different priorities that stand for the relative speed of task execution and have different prices:
1. Normal priority;
2. High priority.