No. The Yelp Places API, which replaced Yelp Fusion, has a 30-day trial with 5,000 calls and then a paid plan from $229 a month. The trial is for evaluation, not production. For Yelp search results and business profiles as JSON without a subscription, our Yelp API costs 1 credit a call.
What the Yelp Places API costs
The Yelp Places API is for consumer-facing apps that show Yelp businesses, with a business email to sign up. Each plan has a monthly fee plus a price for each extra 1,000 calls:
| Plan | Per month | Each extra 1,000 calls | Review excerpts |
|---|---|---|---|
| Base | $229 | $5.91 | None |
| Enhanced | $299 | $6.57 | Up to 3 |
| Premium | $643 | $14.13 | Up to 7, plus Review Highlights |
Yelp's FAQ says the API "does not return full review text". Excerpts run about 160 characters, and you can't choose which ones. Its docs FAQ says plans include 30,000 calls a month by default. Paid plans have a daily limit of 5,000 calls, and above 150,000 calls a month the price goes through Yelp's sales team.
Yelp data with ToolzerHub
We make ToolzerHub. Our Yelp API has two routes, each 1 credit a call:
/v1/yelp/search: one page of Yelp's results for a search and a place, ads marked/v1/yelp/business: a business's rating, review count, categories, phone, price band, address and photos
export TOOLZERHUB_API_KEY=your_key
curl -H "x-api-key: $TOOLZERHUB_API_KEY" \
"https://api.toolzerhub.com/v1/yelp/business?alias=katzs-delicatessen-new-york"
alias is the part of a Yelp link after /biz/; a full link works too. The response, trimmed:
{
"alias": "katzs-delicatessen-new-york",
"name": "Katz's Delicatessen",
"rating": 4.1,
"review_count_display": "17.1k",
"phone": "(212) 254-2246",
"price_range": "$$",
"categories": ["Delis", "American"],
"address": {"street_address": "205 E Houston St", "locality": "New York", "region": "NY", "postal_code": "10002"},
"reviews": null
}
The review count is Yelp's display text, such as "17.1k". Organic search rows carry the business alias, not its details, so a lead list is one search call plus one business call per result. Neither route returns review text.
Build a lead list from a Yelp search
The script runs one search, keeps the organic results, reads each business and writes name, rating, review count, phone and address to a CSV. A business whose page doesn't load is skipped. Install requests (pip install requests) and save it as yelp_leads.py.
import csv
import html
import os
import sys
import time
import requests
API = "https://api.toolzerhub.com/v1/yelp"
HEADERS = {"x-api-key": os.environ.get("TOOLZERHUB_API_KEY", "")}
FIELDS = ["rank", "name", "rating", "review_count", "price_range", "phone", "categories",
"street_address", "locality", "postal_code", "url"]
def get(op, params, tries=3):
# Retry rate limits, server errors and dropped connections.
for attempt in range(tries):
last = attempt == tries - 1
try:
r = requests.get(f"{API}/{op}", headers=HEADERS, params=params, timeout=120)
except requests.RequestException:
if last:
raise
time.sleep(5 * (attempt + 1))
continue
if r.status_code in (429, 500, 502, 503, 504) and not last:
time.sleep(5 * (attempt + 1))
continue
r.raise_for_status()
return r.json()["data"]
def main(what, where, pages="1", out="yelp_leads.csv"):
organic, ads = [], 0
for page in range(int(pages)):
data = get("search", {"find_desc": what, "find_loc": where, "start": page * 10})
ads += data["ad_count"]
for section in data["sections"]:
organic += [r for r in section["results"] if not r["is_ad"] and r["alias"]]
print(f"{what} in {where}: {data['pagination']['total_results']} results; "
f"{len(organic)} organic and {ads} ads on {pages} page(s)")
with open(out, "w", newline="", encoding="utf-8") as f:
writer = csv.DictWriter(f, fieldnames=FIELDS)
writer.writeheader()
for rank, row in enumerate(organic, 1):
try:
biz = get("business", {"alias": row["alias"]})
except requests.HTTPError as e:
print(f" #{rank} {row['alias']}: skipped ({e.response.status_code})")
continue
if not biz:
continue
name, address = html.unescape(biz["name"]), biz.get("address") or {}
writer.writerow({
"rank": rank, "name": name, "rating": biz["rating"],
"review_count": biz["review_count_display"], "price_range": biz["price_range"],
"phone": biz["phone"], "categories": "; ".join(biz["categories"] or []),
"street_address": address.get("street_address"), "locality": address.get("locality"),
"postal_code": address.get("postal_code"), "url": biz["url"],
})
print(f" #{rank} {name}: {biz['rating']} from {biz['review_count_display']}, {biz['phone']}")
if __name__ == "__main__":
if len(sys.argv) < 3:
sys.exit('usage: python yelp_leads.py plumber "Austin, TX" [pages] [out.csv]')
if not HEADERS["x-api-key"]:
sys.exit("set TOOLZERHUB_API_KEY first")
main(*sys.argv[1:])
What three searches showed
python yelp_leads.py plumber "Austin, TX" and the same for dentists in Chicago and pizza in New York saved 28 businesses with a phone number each.
| Search | Organic results | Ads on page 1 | Ratings of saved businesses |
|---|---|---|---|
| Plumber, Austin | 10 | 21 | 4.7 to 4.9, one with no reviews |
| Dentist, Chicago | 10 | 10 | 4.3 to 4.9 |
| Pizza, New York | 10 | 6 | 4.1 to 4.6 |
On the plumber search, ads outnumbered organic results two to one; the script keeps only the 10 organic ones. Review counts are small for trades and dentists, 13 to 532, while 8 of the 9 New York pizzerias have more than 1,000.
What it costs
Ten leads are 11 credits: one search and ten business calls. The 100 free credits a month cover about 90 leads; $19 buys 10,000 credits that never expire, and plans for higher volume cover a city-wide list every week. Set your key and the first lead list is a CSV in a couple of minutes.
For Google's side, see the Google reviews API and how to scrape Google Maps.
Sources
- Yelp Places API plans, https://business.yelp.com/data/products/places-api/
- Yelp Places API FAQ, https://docs.developer.yelp.com/docs/places-faq
- ToolzerHub pricing, https://toolzerhub.com/pricing
We are not affiliated with Yelp.