People who search for a "Yelp API key" usually want one of two things. One is Yelp's official Places API (still called Yelp Fusion in parts of its docs), for showing business details and ratings in an app. The other is Yelp business and review data for a lead list, a local-SEO tool or reputation tracking. Yelp's API now has a monthly price for both. Both are covered here, with Yelp's plans as of November 2026.
The short answer: choose a plan on Yelp's Places API page, start the free trial and fill in the create new app form. Yelp generates a private API key when the app is created. After 30 days and 5,000 trial calls, plans start at $229 a month. A Social Fetch key is a separate credential for public Yelp data, billed per lookup.
Two different things called a Yelp API key
| Yelp Places API | Social Fetch Yelp routes | |
|---|---|---|
| What you get | One private API key | One sfk_… key |
| How you get it | Choose a plan, start a trial, create an app | Create it on the API Keys page |
| Business search and details | Yes | Yes |
| Reviews | Excerpts only, by plan | Public review text, with owner replies |
| Photos | Up to 3 or 12, by plan | Yes, paged |
| Pricing | Monthly plan after a 30-day trial | Credits per lookup, no monthly plan |
| Limits | Daily and monthly caps per plan | Credits and available service capacity |
See the Yelp platform page for every Social Fetch route.
How to get an official Yelp API key
Yelp's authentication guide sets out three steps as of November 2026:
- Choose a plan. On the Yelp Places API page, pick the plan that fits and start the free trial. There's no plan-free developer key any more.
- Create the app. In the create new app form, enter information about your app and agree to the terms, then click Submit.
- Copy your key. Yelp's getting started page says your private API key is generated automatically when the app is created.
Send the key in the Authorization header on every request. With it in YELP_API_KEY:
Yelp asks you to keep the key to yourself: it is the only credential on your calls. There's no separate client ID or OAuth step for these endpoints. For a commercial use case inside a consumer product, Yelp points you to its Places Enterprise application instead.
A Yelp key is tied to a paid plan. A leaked key spends your plan's calls, and any overage, until you rotate it.
Yelp Fusion vs the Yelp Places API
They are the same API. Yelp's developer docs now title it the Yelp Places API, while still listing the endpoints as "Yelp Fusion API endpoints" and keeping fusion in many URLs. Older tutorials that say "create a Yelp Fusion app" describe the same key, from before the move to paid plans. If a guide promises a free Yelp key with no trial or plan, it is out of date.
Is the Yelp API free?
Only for the trial. Yelp's plan page lists, as of November 2026:
| Plan | Monthly price | Each extra 1,000 calls | What's included |
|---|---|---|---|
| Base | $229 | $5.91 | Base attributes and filters; no photos; no review excerpts |
| Enhanced | $299 | $6.57 | Enhanced attributes; up to 3 photos and 3 review excerpts |
| Premium | $643 | $14.13 | Premium attributes and filters; up to 12 photos, 7 review excerpts and the Review Highlights endpoint |
Every plan starts with a 30-day trial that includes 5,000 free API calls. Review excerpts are short: Yelp's FAQ describes them as the first 160 characters of each review, and its FAQ still uses older plan names, so confirm the review terms with Yelp before you build on them.
Yelp API rate limits
Yelp's plan page says going over your limit returns HTTP 429, and limits reset at midnight UTC. Yelp asks you to contact it if you need more than 5,000 API calls a day or more than 150,000 a month. Check the plan page for your plan's exact allowance before sizing a job.
Social Fetch's Yelp routes have no daily quota; requests spend credits. When capacity is full, a request may return 503 temporarily_unavailable with a Retry-After header, which isn't charged. See Credits and Errors.
Get a Social Fetch key for public Yelp data
Social Fetch's Yelp routes accept a Social Fetch key, so you don't need a Yelp plan, trial or app. They return public data as JSON. The key does not grant any permission under Yelp's terms; check those for your use.
- Create a free account or sign in.
- Open API Keys, type a name for the key and click Create key.
- Copy the key from the Save your API key window. It starts with
sfk_and is shown only once. - Try a search in the Playground: the link fills in
coffeenearAustin, TX. Click Send. The Playground uses your signed-in workspace and spends its credits; you do not paste a key. - Store the key in an environment variable named
SOCIALFETCH_API_KEYand call the routes from your own code. Keep it on your server, out of public repositories and browser code.
Each search row includes the business alias. Pass it to the details, reviews or photos route. Each endpoint page shows what a lookup costs, and successful responses say what they cost in meta.creditsCharged. Lookups that fail (502 lookup_failed, 503 temporarily_unavailable) are free. Plans and credit packs are on Pricing.
The Yelp routes:
- Business search: businesses by name or category near a location, with rating, review count, price range and address.
- Reviews: recommended, not recommended and removed reviews, with rating, text, date and owner replies.
- Business details and photos, by alias or Yelp URL: see the Yelp platform page and the Yelp API reference.
These routes read publicly visible data only. They can't post reviews, reply as an owner or manage a listing.
Which key do you need?
Get a Yelp Places API key when you're showing Yelp business data inside a consumer product under Yelp's display terms, and the monthly plan fits your volume. For a commercial consumer product, Yelp wants you on its Enterprise route.
Use a Social Fetch key when the job is reading public business and review data in bursts: auditing a client's reviews, building a local lead list or tracking competitors' ratings, without a monthly plan or review excerpts cut at 160 characters. The same split applies on other networks; the Reddit API key guide walks through it for Reddit.
FAQ
How do I get a Yelp API key?
Go to Yelp's Places API page, choose a plan and start the free trial, then fill in the create new app form, agree to the terms and click Submit. Yelp generates your private API key when the app is created. Send it as Authorization: Bearer followed by the key on every request.
Is the Yelp API free?
Not any more. As of November 2026 every Yelp Places API plan starts with a 30-day trial that includes 5,000 free API calls. After that, Yelp lists Base at $229 per month, Enhanced at $299 and Premium at $643, each with a charge per extra 1,000 calls.
Does the Yelp API return full reviews?
No. As of November 2026 Yelp's plan table gives no review excerpts on Base, up to 3 on Enhanced and up to 7 on Premium. Yelp's FAQ describes excerpts as the first 160 characters of each review.
What are the Yelp API rate limits?
Yelp's plan page says going over your limit returns HTTP 429 and limits reset at midnight UTC. Yelp asks you to contact it if you need more than 5,000 calls a day or more than 150,000 a month.
Do I need a Yelp developer account to use Social Fetch?
No. Social Fetch's Yelp routes take a Social Fetch key (it starts with sfk_) in the x-api-key header. They return public business search results, business details, reviews and photos with no monthly plan, and they cannot post reviews or manage a listing.