yelp.com.au APIyelp.com.au ↗
Search Yelp Australia businesses by location, retrieve detailed profiles with ratings and categories, and pull paginated reviews with author data via 3 REST endpoints.
curl -X GET 'https://api.parse.bot/scraper/ccb9b044-144d-41ce-83ee-e10f5ae298a0/search_businesses?query=restaurants&start=0&location=Sydney+NSW' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for businesses in a specific location. Returns business names, ratings, categories, and addresses extracted from Yelp Australia search results.
| Param | Type | Description |
|---|---|---|
| query | string | Search query (e.g., 'movers', 'removalists') |
| start | integer | Offset for pagination |
| locationrequired | string | Location to search (e.g., 'Sydney NSW', 'Melbourne VIC') |
{
"type": "object",
"fields": {
"businesses": "array of business objects with name, alias, encid, rating, review_count, categories, address, and is_ad fields"
},
"sample": {
"data": {
"businesses": [
{
"name": "Gentleman & A Van",
"alias": "gentleman-and-a-van-sydney",
"encid": "eL3VvaB9F0g9LtP5xcLE5A",
"is_ad": false,
"rating": 4.3,
"address": "Sydney",
"categories": [
"Removals"
],
"review_count": 4
}
]
},
"status": "success"
}
}About the yelp.com.au API
The Yelp Australia API exposes 3 endpoints for querying Yelp AU business listings, profiles, and customer reviews. The search_businesses endpoint returns up to hundreds of results per query — including business names, aliases, ratings, review counts, and addresses — filtered by keyword and Australian location. Separate endpoints deliver detailed business profiles and paginated full-text reviews with author data.
Business Search
The search_businesses endpoint accepts a location parameter (required) such as 'Sydney NSW' or 'Melbourne VIC' and an optional keyword query (e.g. 'removalists', 'dentist'). Results include each business's name, alias, encid, rating, review_count, categories, address, and an is_ad flag that distinguishes promoted listings from organic results. Use the start integer to paginate through result pages.
Business Details
The get_business_details endpoint accepts either an alias (e.g. 'the-ivy-sydney') or a biz_id (the encid returned by search). At least one of these must be supplied. The response includes structured location data — city, regionCode, and postalCode — along with categories as an array of title strings, a numeric rating, review_count, and a rating_distribution array that breaks down counts from 5 stars down to 1 star.
Reviews
The get_business_reviews endpoint takes a required biz_id and supports cursor-based pagination via the after parameter, using the next_cursor value from a previous response. Each review object carries an id, full text, rating, date, and author profile fields. The endpoint also returns a rating_distribution array, making it straightforward to display star breakdowns alongside individual reviews. Use the limit parameter to control page size.
- Aggregate and compare business ratings across multiple Australian cities using
search_businesseslocation queries. - Build a local business directory for a specific trade category by filtering
categoriesfromget_business_detailsresponses. - Monitor review sentiment over time by collecting
textandratingfields fromget_business_reviewswith cursor-based pagination. - Identify paid versus organic Yelp listings by reading the
is_adflag insearch_businessesresults. - Display star-rating breakdowns on a comparison tool using
rating_distributionfromget_business_details. - Enrich a CRM or lead list with structured address data (
city,regionCode,postalCode) fromget_business_details. - Track reviewer profiles and review dates to analyse recency and engagement patterns for a set of businesses.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Yelp have an official developer API?+
What does `get_business_reviews` return beyond review text?+
id, full text, numeric rating, date, and an author profile. The response also includes a rating_distribution array (5 stars to 1 star) and a next_cursor string for fetching the next page of results.Does the API return phone numbers or hours of operation for businesses?+
get_business_details returns name, rating, location (city, regionCode, postalCode), categories, review count, and rating distribution. Phone numbers, opening hours, and website URLs are not included in the current response shape. You can fork this API on Parse and revise it to add those fields.Is there a way to filter search results by rating or category directly?+
search_businesses endpoint supports query and location filtering but does not accept a minimum rating or category filter as direct parameters. The categories and rating fields are returned per business, so filtering can be applied client-side after retrieving results. You can fork this API on Parse and revise it to add server-side category or rating filter parameters.How does pagination work across the three endpoints?+
search_businesses uses an integer start offset. get_business_reviews uses cursor-based pagination: the response includes a next_cursor string (or null when no more pages exist) which you pass as the after parameter in the next request. get_business_details returns a single record and has no pagination.