Yelp 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.
What is the Yelp 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.
curl -X GET 'https://api.parse.bot/scraper/ccb9b044-144d-41ce-83ee-e10f5ae298a0/search_businesses?query=movers&start=0&location=Sydney+NSW' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace yelp-com-au-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.yelp_australia_business_reviews_api import YelpAustralia, BusinessSummary, Business, Review
yelp = YelpAustralia()
# Search for removalists in Sydney
for biz in yelp.businesses.search(location="Sydney NSW", query="movers"):
print(biz.name, biz.rating, biz.review_count, biz.categories)
# Get full details for the first result
detail = biz.details()
print(detail.name, detail.rating, detail.location.city, detail.location.postal_code)
print(detail.rating_distribution)
# List reviews via constructible Business
business = yelp.business(encid=biz.encid)
for review in business.reviews.list():
print(review.rating, review.date, review.author.name, review.author.review_count)
break
Full-text search for businesses in a specific Australian location. Returns up to 10 results per page with business names, ratings, categories, and addresses. Pagination is offset-based via `start` (increments of 10). Results include both organic listings and ads (flagged via `is_ad`). An empty `query` returns popular businesses in the location.
| Param | Type | Description |
|---|---|---|
| query | string | Search query (e.g., 'movers', 'removalists', 'restaurants') |
| start | integer | Offset for pagination, increments of 10 |
| locationrequired | string | Location to search in format 'City STATE' (e.g., 'Sydney NSW', 'Melbourne VIC', 'Brisbane QLD') |
{
"type": "object",
"fields": {
"businesses": "array of business summary 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 API
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.
The Yelp API is a managed, monitored endpoint for yelp.com.au — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when yelp.com.au changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official yelp.com.au API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.