Prisma Reviews / Guides / Yelp Fusion API

Yelp Fusion API

The Yelp Fusion API, now documented as the Yelp Places API, is Yelp’s REST API at https://api.yelp.com/v3: you authenticate with a private API key as a Bearer token, find businesses with /businesses/search, read details with /businesses/{id}, and get up to 3 review excerpts with /businesses/{id}/reviews on the Enhanced or Premium plan. It’s paid after a 30-day trial of 5,000 calls. For what the API can and can’t do overall, start with our Yelp API guide.

Endpoints and limits checked against Yelp’s developer docs on November 10, 2026.

Is Yelp Fusion the same as the Yelp Places API?

Yes. Yelp renamed the consumer-facing product to the Yelp Places API; the base URL (/v3), the endpoints and the API keys stayed the same. Libraries, Stack Overflow answers and GitHub repos still say Fusion. A separate product, the Yelp Insights API, serves internal analytics and has different terms.

How do you get a Yelp Fusion API key?

  1. Choose a Places API plan on Yelp’s Places API page. Each plan starts with a 30-day trial of 5,000 calls.
  2. Create an app on the Yelp developer site: name, description, contact email.
  3. Accept the API Terms of Use and the Display Requirements.
  4. Copy the API Key from the Manage App page. Keep it server-side: Yelp doesn’t allow calls from the browser, so put a small backend in front.

Every request sends it as a header:

Shell
-H "Authorization: Bearer $YELP_API_KEY"

Which Yelp Fusion endpoints should you know?

EndpointMethodUse it toPlan
/v3/businesses/searchGETFind businesses by term and location (or latitude/longitude)Any
/v3/businesses/search/phoneGETFind a business by phone numberAny
/v3/businesses/matchesGETMatch your own records (name, address) to Yelp IDsAny
/v3/businesses/{id_or_alias}GETDetails: hours, categories, rating, review count, photosAny (photos from Enhanced)
/v3/businesses/{id_or_alias}/reviewsGETUp to 3 review excerptsEnhanced or Premium
/v3/autocompleteGETSuggestions while a user typesAny

How do you search for businesses with the Yelp API?

api.prismareviews.com/v1
curl "https://api.yelp.com/v3/businesses/search?term=tacos&location=Austin,TX&sort_by=rating&limit=10" \
  -H "Authorization: Bearer $YELP_API_KEY"

Each business has an id (and alias), name, rating, review_count, price, categories, coordinates, location and a url back to Yelp. Keep the id: every other endpoint takes it.

How do you get reviews from the Yelp Fusion API?

Python
import os, requests

r = requests.get(
    "https://api.yelp.com/v3/businesses/BUSINESS_ID_OR_ALIAS/reviews",
    params={"locale": "en_US", "sort_by": "yelp_sort"},
    headers={"Authorization": f"Bearer {os.environ['YELP_API_KEY']}"},
    timeout=15,
)
r.raise_for_status()
data = r.json()
print(data["total"], "reviews on Yelp,", len(data["reviews"]), "excerpts returned")
for rev in data["reviews"]:
    print(rev["rating"], rev["user"]["name"], rev["text"], rev["url"])

What to expect:

Why the cap exists, plan by plan: Yelp API review limit.

How do Yelp Fusion API rate limits work?

SituationResponseWhat to do
Daily limit reached429 with ACCESS_LIMIT_REACHEDWait for the reset (midnight UTC) or upgrade
Too many calls per second429 with TOO_MANY_REQUESTS_PER_SECONDBack off and retry with jitter
Bad or missing key401 with TOKEN_INVALID / TOKEN_MISSINGCheck the Authorization header
Endpoint not in your planError responseCheck your plan’s endpoints

Every response carries RateLimit-DailyLimit, RateLimit-Remaining and RateLimit-ResetTime headers; log them. Yelp bills at least 1,000 calls a day on paid plans. Costs in Yelp API pricing.

What do Yelp’s display requirements ask for?

When you show Yelp data you accept Yelp’s Display Requirements: attribute the content to Yelp, link back to the business page on Yelp, and show ratings the way Yelp specifies. Read them before you design the UI, because they shape what your screens can look like.

When is the Yelp Fusion API the wrong tool?

When you want your own reviews in full: to answer them, track them or put them next to Google and Trustpilot. Fusion is built to display Yelp content in other apps, with 3 excerpts per business. Prisma reads the full public reviews of Yelp listings you own or manage, read only, in the same JSON as 80+ platforms:

cURL
curl "https://api.prismareviews.com/v1/reviews?platform=yelp&limit=50" \
  -H "Authorization: Bearer pk_test_YOUR_KEY"
Yelp Fusion (Places API)Prisma Yelp connector
Reviews per business3 excerpts (7 on Premium)Full public reviews of your listings
Whose businessesAnyOnly listings you own or manage
ReplyNoNo (url to reply on Yelp)
PriceFrom $299/mo for reviews1 paid read per review; Beam €49/mo with 2,500 reads
Other platformsNo80+ in the same format

FAQ

Is the Yelp Fusion API free?

No. There’s a 30-day trial with 5,000 calls; after that the Places API costs $229, $299 or $643 a month, and reviews need the $299 Enhanced plan or higher.

What is the base URL of the Yelp Fusion API?

https://api.yelp.com/v3, with your API key sent as Authorization: Bearer on every request.

How many reviews does the Yelp Fusion API return?

Up to 3 review excerpts per business on Enhanced and up to 7 on Premium. Paging with offset doesn’t return more.

Can I call the Yelp API from the browser?

No. Yelp’s API doesn’t support calls from browser JavaScript, and it would expose your key anyway. Call it from your server and pass the results to your front end.

Does the Yelp Fusion API still work in 2026?

Yes, as the Yelp Places API, with the same /v3 endpoints. What changed is pricing: there’s no free tier after the trial.

Your Yelp reviews, in full, next to every other platform

Read every public review of your own Yelp listings in the same JSON as Google Maps, Trustpilot and 80+ more. Read only on Yelp, with a link to reply there.

Get a free API key

Test keys (pk_test_) return sample data from the first minute.

Next step: read the reviews as JSON with the Yelp reviews API, and compare plans on Prisma Reviews pricing.

Get your API key in a minute

Free Spark plan: 2 locations, no card. Test keys return sample data on all 84 platforms, so you can build before connecting a real one.