Search Yelp local businesses by keyword and city/location

GET/v1/yelp/search5 Credits / business (0 Credits on empty)($0.0005 / business ($0.20–$0.50 / 1K businesses))· Updated 2026-11-15

Direct Answer · Engineering Summary

GET /v1/yelp/search discovers local businesses on Yelp by keyword and city/address (and supports /v3/businesses/search drop-in routing), returning business_id, alias, name, unrounded rating, review_count, price_range, categories, phone, address, and coordinates at 5 Credits per business ($0.20–$0.50 per 1,000 businesses, 0 Credits on empty).

Honest Trade-Offs & Scope Boundaries

→Returns directory-level business metadata and aggregate ratings; call GET /v1/yelp/reviews with alias or business_id for full customer review text.
→Public search rankings follow Yelp's local relevance ordering for the queried city or neighborhood.
→Read-only local business intelligence; managing Yelp Ads or claiming storefronts is out of scope.

Searches Yelp local businesses by keyword and location with unrounded average ratings, total review counts, price tiers, categories, phone numbers, street addresses, and coordinates. Drop-in compatible with /v3/businesses/search.

Parameters

querystringrequired
Search keyword or category (e.g. coffee, sushi, dentist).
Example: coffee
locationstringrequired
City, neighborhood, state, or postal address (e.g. Austin, TX).
Example: Austin, TX
limitinteger (1 to 50)
Maximum businesses to return (1–50).
Example: 20

Example Request (cURL / Python / JavaScript)

curl "https://api.reviewsdataapi.com/v1/yelp/search?query=coffee&location=Austin%2C+TX" \
  -H "x-api-key: rv_live_your_api_key"

import requests

res = requests.get(
    "https://api.reviewsdataapi.com/v1/yelp/search?query=coffee&location=Austin%2C+TX",
    headers={"x-api-key": "rv_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.reviewsdataapi.com/v1/yelp/search?query=coffee&location=Austin%2C+TX", {
  headers: { "x-api-key": "rv_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://reviewsdataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "platform": "yelp",
    "query": "coffee",
    "location": "Austin, TX",
    "total_estimated": 240,
    "businesses": [
      {
        "business_id": "0wljsy6_0HIni0pooc5ozw",
        "alias": "mr-natural-austin",
        "name": "Mr Natural",
        "rating": 3.9,
        "review_count": 535,
        "price_level": "$$",
        "is_closed": false,
        "phone": "(512) 477-5228",
        "yelp_url": "https://www.yelp.com/biz/mr-natural-austin",
        "categories": [
          {
            "alias": "vegetarian",
            "title": "Vegetarian"
          },
          {
            "alias": "gluten_free",
            "title": "Gluten-Free"
          }
        ],
        "neighborhoods": [
          "East Cesar Chavez",
          "East Austin"
        ],
        "address": {
          "line1": "1901 E Cesar Chavez St",
          "city": "Austin",
          "state": "TX",
          "postal_code": "78702",
          "country_code": "US",
          "formatted": "1901 E Cesar Chavez St, Austin, TX 78702"
        },
        "coordinates": {
          "latitude": 30.2568239,
          "longitude": -97.7245513
        },
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/tTIAWYxFat7PSRu1Gbazkw/o.jpg"
      },
      {
        "business_id": "AyrhZPOm5BCSTN_hl-_xrg",
        "alias": "swedish-hill-austin-7",
        "name": "Swedish Hill",
        "rating": 4.5,
        "review_count": 18,
        "price_level": "$$",
        "is_closed": false,
        "phone": "(512) 882-6610",
        "yelp_url": "https://www.yelp.com/biz/swedish-hill-austin-7",
        "categories": [
          {
            "alias": "cafes",
            "title": "Cafes"
          },
          {
            "alias": "bakeries",
            "title": "Bakeries"
          },
          {
            "alias": "delis",
            "title": "Delis"
          }
        ],
        "neighborhoods": [
          "Warehouse District",
          "Downtown"
        ],
        "address": {
          "line1": "415 Colorado St",
          "city": "Austin",
          "state": "TX",
          "postal_code": "78701",
          "country_code": "US",
          "formatted": "415 Colorado St, Unit 102, Austin, TX 78701"
        },
        "coordinates": {
          "latitude": 30.267103909890537,
          "longitude": -97.74430223241814
        },
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/Yr0bYXRFHzkT_1a6bZVfPQ/o.jpg"
      }
    ]
  },
  "meta": {
    "request_id": "fd70b8df-859c-43f0-802f-71a798a4042b",
    "endpoint": "/v1/yelp/search",
    "items_returned": 20,
    "credits_charged": 100,
    "cached": true,
    "took_ms": 1
  }
}

Response Fields

Normalized cross-platform reputation, star distribution, and sentiment JSON payload.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string	Example: https://reviewsdataapi.com
`status`	string	Example: ok
`msg`	string	Example: success
`data`	object
`platform`	string	Example: yelp
`query`	string	Example: coffee
`location`	string	Example: Austin, TX
`total_estimated`	integer	Example: 240
`businesses`	array of object
`business_id`	string	Example: 0wljsy6_0HIni0pooc5ozw
`alias`	string	Example: mr-natural-austin
`name`	string	Example: Mr Natural
`rating`	number	Example: 3.9
`review_count`	integer	Example: 535
`price_level`	string	Example: $$
`is_closed`	boolean	Example: false
`phone`	string	Example: (512) 477-5228
`yelp_url`	string	Example: https://www.yelp.com/biz/mr-natural-austin
`categories`	array of object
`neighborhoods`	array of string
`address`	object
`coordinates`	object
`photo_url`	string	Example: https://s3-media0.fl.yelpcdn.com/bphoto/tTIAWYxFat7PSRu1Gbaz
`meta`	object
`request_id`	string	Example: fd70b8df-859c-43f0-802f-71a798a4042b
`endpoint`	string	Example: /v1/yelp/search
`items_returned`	integer	Example: 20
`credits_charged`	integer	Example: 100
`cached`	boolean	Example: true
`took_ms`	integer	Example: 1

Status Codes

200: Normalized cross-platform reputation, star distribution, and sentiment JSON payload.
400: Missing or invalid query parameter (0 credits charged).
401: Missing or invalid rv_live_ API key.
402: Insufficient credit balance.