Skip to main content
The Yelp Search Scraper API allows users to get results from the Yelp search page. This API enables searching for businesses by keyword and location.
HasData is an independent service and is not affiliated with, endorsed by, or sponsored by Yelp. Yelp is a trademark of its respective owner. This API works with publicly available data only.

Get Your API Key

Sign in at hasdata.com, go to your account settings, and copy your API key. All requests must include your key in the x-api-key header.

Request Cost and API Credits

Each request to the Yelp Search Scraper API consumes API Credits from your account balance.
  • Cost per request: 10 API Credits
  • Credits are deducted only for successful requests.
  • Your total available credits depend on your active plan.
You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.
Unused credits do not roll over. Any remaining credits expire at the end of the current billing period.
To monitor your credit usage and remaining balance, sign in to your account dashboard at app.hasdata.com.

Make Your First Request

curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/yelp/search' \
  --data-urlencode 'keyword=McDonald'\''s' \
  --data-urlencode 'location=New York, NY' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'
hasdata yelp-search \
  --keyword 'McDonald'\''s' \
  --location 'New York, NY'
const axios = require('axios').default;

const options = {
  method: 'GET',
  url: 'https://api.hasdata.com/scrape/yelp/search',
  params: {keyword: 'McDonald\'s', location: 'New York, NY'},
  headers: {'Content-Type': 'application/json', 'x-api-key': '<your-api-key>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}
import requests

url = "https://api.hasdata.com/scrape/yelp/search"

querystring = {"keyword":"McDonald's","location":"New York, NY"}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "<your-api-key>"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
<?php

$params = [
    "keyword" => "McDonald's",
    "location" => "New York, NY",
];

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hasdata.com/scrape/yelp/search?" . http_build_query($params),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <your-api-key>",
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
OkHttpClient client = new OkHttpClient();

HttpUrl url = HttpUrl.parse("https://api.hasdata.com/scrape/yelp/search")
  .newBuilder()
  .addQueryParameter("keyword", "McDonald's")
  .addQueryParameter("location", "New York, NY")
  .build();

Request request = new Request.Builder()
  .url(url)
  .get()
  .addHeader("Content-Type", "application/json")
  .addHeader("x-api-key", "<your-api-key>")
  .build();

Response response = client.newCall(request).execute();
using System.Net.Http;
using System.Web;

var client = new HttpClient();

var query = HttpUtility.ParseQueryString(string.Empty);
query["keyword"] = "McDonald's";
query["location"] = "New York, NY";

var url = $"https://api.hasdata.com/scrape/yelp/search?{query}";

var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("x-api-key", "<your-api-key>");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
require 'net/http'
require 'uri'

uri = URI("https://api.hasdata.com/scrape/yelp/search")
params = {
  "keyword" => "McDonald's",
  "location" => "New York, NY",
}
uri.query = URI.encode_www_form(params)

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Content-Type"] = 'application/json'
request["x-api-key"] = '<your-api-key>'

response = http.request(request)
puts response.read_body
use reqwest::blocking::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let res = client
        .get("https://api.hasdata.com/scrape/yelp/search")
        .query(&[("keyword", "McDonald's")])
        .query(&[("location", "New York, NY")])
        .header("Content-Type", "application/json")
        .header("x-api-key", "<your-api-key>")
        .send()?
        .text()?;
    println!("{}", res);
    Ok(())
}
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	params := url.Values{}
	params.Set("keyword", "McDonald's")
	params.Set("location", "New York, NY")

	u := "https://api.hasdata.com/scrape/yelp/search?" + params.Encode()

	req, _ := http.NewRequest("GET", u, nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("x-api-key", "<your-api-key>")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

API Parameters

ParameterDefault ValueRequiredDescription
keywordMcDonald’sYesThe search term for which to get the search results.
locationNew York, NYYesThe location where to search for businesses with the given keyword.
l-NoParameter defines the distance or map radius for the search results. For example: g:-95.2486,29.8496,-95.4277,29.6324.
domain-NoYelp domain to use. Default is www.yelp.com.
start-NoResult offset for pagination (e.g., 0 for the first page, 10 for the 2nd page, etc.).