NAVNavbar
Logo
cURL php NodeJS Python cSharp

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

The returned results are specific to the indicated business entity or keyword, as well as location and language parameters.

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.

Alternatively, the 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:
https://www.yelp.com/biz/intercontinental-singapore-singapore-2

The alias of this hotel is intercontinental-singapore-singapore-2.

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.

Methods

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 pingback_url or 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 pingback_url or 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.

The cost can be calculated on the Pricing page. You can check your spending in your account dashboard or by making a separate call to the User Data endpoint