n8n-nodes-scrapehero
v0.1.2
Published
n8n community node for accessing ScrapeHero Marketplace APIs including Amazon, Google Maps, Walmart, real estate, travel, jobs, and ecommerce data.
Readme
n8n-nodes-scrapehero
This is an n8n community node for accessing ScrapeHero Marketplace APIs. It allows you to scrape data from popular e-commerce platforms, real estate websites, search engines, travel sites, and review platforms directly within your n8n workflows.
Note: A valid ScrapeHero Marketplace API key is required to use this node.
Features
- Single Integrated Node: Easily access 17 ScrapeHero Marketplace web scraping APIs from a single n8n node.
- Unified Credential Management: Single reusable
ScrapeHero APIcredential for managing your API key across all operations. - Dynamic API Selector: Select the desired API from a dropdown to dynamically reveal relevant input parameters.
- Secure Authentication: Automatic API key injection handled securely via n8n's credential system.
- Structured JSON Output: Clean, parsed JSON data returned directly to your n8n workflow for seamless downstream processing.
- Workflow & AI Ready: Integrate scraping results with databases, Google Sheets, webhooks, or AI Agents in n8n.
Supported APIs
| API | Input Parameters | | --- | --- | | Airbnb Search API | Search URL | | Amazon Best Seller API | Amazon Best Sellers URL, Page | | Amazon Offer Listing API | ASIN, Country Code | | Amazon Product Details and Pricing API | ASIN, Country Code | | Amazon Search API | Keyword, Country Code, Page | | Glassdoor Job Results API | Job Search URL | | Google Maps Search API | Search Input | | Google Reviews API | Place ID, Sort | | Homes Property Details API | Property URL | | Shopify Search API | Store URL | | Tripadvisor Reviews API | Tripadvisor URL, Page | | Trulia Search API | Search URL | | Walmart Product Details and Pricing API | Product ID | | Walmart Product Search API | Search Input | | Walmart Reviews API | Product URL, Page, Sort | | WooCommerce Search API | Website URL | | Yellow Pages Search API | Search URL |
Installation
Community Node Installation (Recommended after npm publication)
- Open your n8n instance.
- Go to Settings > Community Nodes.
- Select Install.
- Enter
n8n-nodes-scrapeheroin the package name field. - Agree to the risks and select Install.
Note: npm installation applies after the package is published to npm.
Local Development / Manual Installation
To install and link this node locally in your n8n development environment:
git clone https://github.com/scrapehero/n8n-nodes-scrapehero.git
cd n8n-nodes-scrapehero
npm install
npm run build
npm linkThen, in your custom n8n directory:
npm link n8n-nodes-scrapeheroCredentials
To configure the ScrapeHero API credential:
- Obtain your API key from the ScrapeHero Marketplace.
- In n8n, create a new credential of type ScrapeHero API.
- Paste your API key into the API Key field.
- Save the credential.
Usage
- Add the ScrapeHero node to your canvas.
- Select your ScrapeHero API credential.
- Select the desired API operation from the dropdown (e.g., Amazon Product Details and Pricing API).
- Fill in the required parameters.
- Execute the node to retrieve scraped JSON data.
Example 1: Amazon Product Details
- API: Amazon Product Details and Pricing API
- ASIN:
B079Y45KTJ - Country Code:
US
Example 2: Google Reviews
- API: Google Reviews API
- Place ID:
ChIJ8xxuwGG2d0gR4zxqSSWXwrI - Sort:
Most Relevant
Example Workflow
Manual Trigger / Schedule
↓
ScrapeHero
↓
Google Sheets / PostgreSQL / AI AgentDevelopment
# Install dependencies
npm install
# Run linter
npm run lint
# Build the project
npm run build
# Development mode with auto-rebuild
npm run devDirectory Structure
nodes/ScrapeHero/- Main node declaration (ScrapeHero.node.tsandScrapeHero.node.json)credentials/- Credential definition (ScrapeHeroApi.credentials.ts)
Authentication
Authentication is handled securely using n8n's this.helpers.httpRequestWithAuthentication function and the defined scrapeHeroApi credential. The API key is attached to request query parameters (x-api-key) and is never hardcoded or exposed in workflow nodes.
Compatibility
- Tested against n8n community node specification v1.0.0+
- Requires n8n
v1.0.0or higher.
