Catalog / Search, maps & leads
SEARCH, MAPS & LEADS
Yelp Business - Business Details from Links
Paste Yelp business links from any Yelp site (yelp.com, yelp.ca, yelp.co.uk, ...) or business aliases.
About this data
Paste Yelp business links from any Yelp site (yelp.com, yelp.ca, yelp.co.uk, ...) or business aliases. Each business becomes one row with name, rating, review count, categories, price range, address, phone, hours, website, coordinates and photo count. Failures are not charged.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/yelp/business
Returns its name, rating, review count, categories, price range, business phone and website, address, coordinates, hours and amenities when supplied by Yelp.
Look up one public business by Yelp link or alias.
Input
Send a JSON body to POST https://api.ssh.autos/v1/yelp/business.
| Field | Type | Required | Notes |
|---|---|---|---|
business | string | required | 1–400 characters |
Returned fields
The answer is JSON: records, a list, and summary, the run status and counts. Each record has these 30 fields; a field the source does not publish comes back null.
30 fields per record
| Field | Type | Notes |
|---|---|---|
businessId | string | Yelp business id (22 characters). |
alias | string | The business's name in Yelp links (yelp.com/biz/<alias>), after any redirect Yelp made. |
name | string | Business name. |
url | string | The business page on yelp.com. |
rating | number | Average star rating (1-5, to one decimal); null when the business has no reviews. |
reviewCount | integer | Number of reviews Yelp counts for the business. |
categories | array of strings | Yelp categories, for example "BBQ & Barbecue". |
priceRange | string | Price range as Yelp shows it, in the business's local currency sign ($$, £££, €). |
phone | string | Phone number as Yelp formats it. |
website | string | The business's own website. |
menuUrl | string | Link to the business's menu, when Yelp has one. |
address | string | Full address on one line. |
street | string | Street lines of the address. |
city | string | City. |
region | string | State, province or region code. |
postalCode | string | Postal code. |
countryCode | string | ISO country code, for example US. |
neighborhoods | array of strings | Neighbourhoods Yelp places the business in. |
latitude | number | Latitude of the map pin. |
longitude | number | Longitude of the map pin. |
timezone | string | IANA time zone of the business. |
hours | array of objects | Regular opening hours per weekday (Mon-Sun) as Yelp shows them, for example ["11:00 AM - 3:00 PM"], ["Closed"] or ["Open 24 hours"]. |
photosCount | integer | Number of photos and videos on the business page. |
amenities | array of objects | Amenities and features Yelp lists, for example {"name": "Offers delivery", "available": false}. |
isClosed | boolean | True when Yelp marks the business as closed. |
isClaimed | boolean | True when the business owner has claimed the Yelp page. |
yearEstablished | string | Year established, as the owner gives it. |
about | string | The owner's description of the business. |
input | string | The link, alias or id this row was read from. |
scrapedAt | string | When the run read the business (UTC). |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/yelp/business -m POST -b '{"business": "franklin-barbecue-austin"}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Yelp Business Scraper - Business Details from Links. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt