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 API credential 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)

1. Open your n8n instance.
2. Go to Settings > Community Nodes.
3. Select Install.
4. Enter n8n-nodes-scrapehero in the package name field.
5. 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 link

Then, in your custom n8n directory:

npm link n8n-nodes-scrapehero

---

Credentials

To configure the ScrapeHero API credential:

1. Obtain your API key from the ScrapeHero Marketplace.
2. In n8n, create a new credential of type ScrapeHero API.
3. Paste your API key into the API Key field.
4. Save the credential.

---

Usage

1. Add the ScrapeHero node to your canvas.
2. Select your ScrapeHero API credential.
3. Select the desired API operation from the dropdown (e.g., Amazon Product Details and Pricing API).
4. Fill in the required parameters.
5. 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 Agent

---

Development

# Install dependencies
npm install

# Run linter
npm run lint

# Build the project
npm run build

# Development mode with auto-rebuild
npm run dev

Directory Structure

• nodes/ScrapeHero/ - Main node declaration (ScrapeHero.node.ts and ScrapeHero.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.0 or higher.

---

Resources

• ScrapeHero Marketplace Documentation
• n8n Community Nodes Documentation

---

License

MIT