Search Yelp businesses
litescrape.yelp.business.searchReturns Yelp businesses in `organic_results`
- Price
- $0.00015/successAt provider cost
- Success rate
- —No success-rate data yetNo success-rate data yet
- Latency p50
- ——
- Last verified
- —Not verified yet
GEThttps://toolswitch.dev/v1/tools/litescrape.yelp.business.search?find_loc=Austin%2C+TX&find_desc=coffeePreview- Uses platform quota
- Synchronous response
- Reads public data
Parameters
Four live requests returned upstream 503 service_unavailable. The documented request contract and price are retained; no successful result is verified yet.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
l | string | Optional | Yelp map-bounds token, up to 1,024 characters. | g:-97.80,30.20,-97.70,30.30 |
cflt | string | Optional | Yelp category identifier, such as coffee. | coffee |
attrs | string | Optional | Comma-separated Yelp attribute filters, such as OutdoorSeating; up to 4,096 characters. | OutdoorSeating |
start | integer | Optional | Result offset from 0 through 10,000. | |
sortby | string | Optional | Result order. | |
timeout | number | Optional | Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline. | |
find_loc | string | Required | Search location, 1 to 500 characters. | Austin, TX |
find_desc | string | Optional | Business name, category, or search terms, up to 500 characters. | coffee |
yelp_domain | string | Optional | Supported first-party localized Yelp hostname, such as www.yelp.co.uk. Links in the response use this hostname. | www.yelp.com |
- Query parameters
lstringOptionalYelp map-bounds token, up to 1,024 characters.
Example:
g:-97.80,30.20,-97.70,30.30cfltstringOptionalYelp category identifier, such as coffee.
Example:
coffeeattrsstringOptionalComma-separated Yelp attribute filters, such as OutdoorSeating; up to 4,096 characters.
Example:
OutdoorSeatingstartintegerOptionalResult offset from 0 through 10,000.
sortbystringOptionalResult order.
timeoutnumberOptionalOptional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
find_locstringRequiredSearch location, 1 to 500 characters.
Example:
Austin, TXfind_descstringOptionalBusiness name, category, or search terms, up to 500 characters.
Example:
coffeeyelp_domainstringOptionalSupported first-party localized Yelp hostname, such as www.yelp.co.uk. Links in the response use this hostname.
Example:
www.yelp.com
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.yelp.business.search?find_loc=Austin%2C+TX&find_desc=coffee' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/litescrape.yelp.business.search?find_loc=Austin%2C+TX&find_desc=coffee",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.yelp.business.search?find_loc=Austin%2C+TX&find_desc=coffee", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.00015/success, including the service fee.