n8n-nodes-yelp-api
v0.1.1
Published
Search Yelp businesses, get business details, and get reviews as structured JSON. Apify-backed n8n community node, pay-per-result, and usable as an AI agent tool.
Downloads
253
Maintainers
Readme
n8n-nodes-yelp-api
An n8n community node for Yelp: search businesses, get full business details, and get reviews as structured JSON. It is backed by John's Yelp Actors on Apify (Search, Business Details, Reviews) and bills per result, so there are no subscriptions and no minimums.
Installation · Credentials · Operations · Output · Example workflows · Pricing · Resources
What it does
One node, three operations:
- Search Businesses — find businesses by term and location (one item per result)
- Get Business Details — full details for a business by its Yelp place ID
- Get Reviews — reviews for a business by its Yelp place ID (one item per review)
It also works as an AI Agent tool, so an agent can look up Yelp data on demand.
Installation
Follow the n8n community nodes installation guide:
- In n8n, open Settings > Community Nodes.
- Select Install.
- Enter
n8n-nodes-yelp-apias the npm package name. - Agree to the risks of using community nodes, then select Install.
After it installs, the Yelp node appears in the nodes panel.
n8n Cloud only allows verified community nodes. Until this node is verified, install it on a self-hosted n8n instance.
Credentials
You need a free Apify account and an API token.
- Sign in to the Apify Console.
- Open Settings > Integrations and copy your Personal API token.
- In n8n, create a new Apify API credential and paste the token.
- Use the credential's Test button to confirm it works.
The node also supports Apify OAuth2 if you prefer to connect that way.
Operations
Search Businesses
| Parameter | Description | | --- | --- | | Search Term | What to search for. Optional. | | Location | The location to search within. Required. | | Category Filter | Yelp category alias. Optional. | | Sort By | recommended, rating, review_count, etc. Optional. | | Maximum Pages | How many result pages to fetch. |
Get Business Details
| Parameter | Description | | --- | --- | | Place ID | The Yelp place ID. Required. | | Include Full Menu | Include the full menu in the result. |
Get Reviews
| Parameter | Description | | --- | --- | | Place ID | The Yelp place ID. Required. | | Sort By | yelp_sort, newest, highest_rated, etc. Optional. | | Minimum Rating | Only reviews at or above this rating. Optional. | | Maximum Pages | How many review pages to fetch. |
Every operation has an Output parameter: Simplified (default — a compact, AI-friendly object) or Raw (every field the API returns). Simplified is used automatically when the node runs as an AI Agent tool.
Output
- Search Businesses → one item per business:
title,categories,snippet,openState,link,reviewsLink,placeIds(Raw addsposition,thumbnail, …). - Get Business Details → one item per place:
name,rating,reviews,categories,address,country,placeIds(Raw adds images, hours, directions, menu, …). - Get Reviews → one item per review:
user,rating,comment,date,position(Raw adds tags, photos, feedback, …).
Example workflows
1. Build a local business list
- Manual Trigger
- Yelp → Search Businesses: Location
Austin, TX, Search Termcoffee, OutputSimplified. - Google Sheets: append each
titleandplaceIds.
2. Pull details and reviews for a business
- Yelp → Get Business Details with a Place ID.
- Yelp → Get Reviews with the same Place ID.
- Aggregate or AI node: summarize sentiment.
3. Let an AI Agent answer Yelp questions
- AI Agent node.
- Attach Yelp as a tool.
- Ask "Find top-rated tacos in Austin and summarize their reviews." The agent calls Search, then Reviews, in Simplified mode.
Pricing
This node calls John's Yelp Actors on Apify, billed pay-per-result, with no subscription and no minimums. Apify also includes a free monthly usage tier. See the Actor pages for current rates: Search · Business Details · Reviews.
Resources
- Yelp Search API on Apify
- Yelp Business Details API on Apify
- Yelp Reviews API on Apify
- npm package
- n8n community nodes documentation
- Apify n8n integration guide
