ToolzerHubPricing

Is the Yelp API free? Places API pricing and plans

No: Yelp's Places API has a 30-day trial, then plans from $229 a month. Our Yelp API returns search results and business profiles at 1 credit a call.

5 min read

Short answer

  • The Yelp API is not free. The Places API, formerly Fusion, gives a 30-day trial with 5,000 calls, for evaluation only.
  • Paid plans run from $229 to $643 a month. The cheapest has no review excerpts, and none return full review text.
  • Our Yelp API returns Yelp's search results with ads marked and each business's rating, phone and address, at 1 credit a call.
On this page

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
bash
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:

json
{
  "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.

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.

python
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

We are not affiliated with Yelp.

Get this data from your own code

The Yelp API returns it as JSON with one x-api-key header. 100 free credits monthly.