# n8n-nodes-outscraper

![Outscraper Logo](https://outscraper.com/wp-content/uploads/2023/11/cropped-logo-long-e1628850886215.webp)

This is an n8n community node for integrating with the [Outscraper API](https://outscraper.com). It allows you to automate data extraction from various online platforms including Google Maps, Google Search, YouTube, Trustpilot, TripAdvisor, Expedia, and G2 Reviews.

[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

[Installation](#installation)  
[Operations](#operations)  
[Credentials](#credentials)  
[Usage](#usage)  
[Example Workflows](#example-workflows)  
[Resources](#resources)  
[Version History](#version-history)  

## Installation

Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

### Community Nodes (Recommended)

For users on n8n v0.187+:

1. Go to **Settings > Community Nodes**
2. Select **Install**
3. Enter `n8n-nodes-outscraper` in the input field
4. Agree to the risks of using community nodes
5. Click **Install**

### Manual Installation

To install the node manually:

1. Open your n8n installation folder
2. Go to the `node_modules` folder
3. Create a new folder called `n8n-nodes-outscraper`
4. Download the [latest release](https://github.com/outscraper/n8n-nodes-outscraper/releases) and extract it into the folder
5. Restart n8n

### npm Installation

To install via npm:

```bash
npm install n8n-nodes-outscraper
```

## Operations

The Outscraper node supports the following platforms and operations:

### Google Maps
- **Search**: Search for businesses on Google Maps
- **Reviews**: Get reviews for businesses on Google Maps
- **Photos**: Get photos for businesses on Google Maps

### Google Search
- **Search**: Perform Google search queries

### Emails & Contacts
- **Find Emails & Contacts**: Find email addresses, social links, and phones from domains

### Email Validator
- **Validate Email**: Validate email addresses before outreach

## Credentials

To use this node, you need an Outscraper API key.

1. Create an account on [Outscraper](https://app.outscraper.com/signup)
2. Navigate to the [account page](https://app.outscraper.com/account/api) to get your API key
3. In n8n, create new credentials of type **Outscraper API**
4. Enter your API key and the API URL (default: https://api.outscraper.cloud)

## Usage

1. Add the Outscraper node to your workflow
2. Select the resource (e.g., Google Maps) you want to work with
3. Choose the operation (e.g., Search, Reviews)
4. Configure the required parameters
5. Connect the node to the rest of your workflow

### Example: Search for Businesses on Google Maps

1. Add the Outscraper node
2. Select **Google Maps** as the resource
3. Select **Search** as the operation
4. Enter your search query (e.g., "coffee shops in New York")
5. Set additional parameters like limit, async mode, etc.
6. Run the workflow to get the search results

## Example Workflows

Importable n8n workflow templates are available in the [`examples`](examples) folder:

* **AI-powered lead generation pipeline**: Google Maps search, contact enrichment, email validation, lead scoring, and CRM push
* **Review sentiment analysis workflow**: Review extraction, OpenAI sentiment analysis, and Slack notification
* **Competitor monitoring agent**: Scheduled Google Maps scraping, snapshot comparison, AI summary, and Slack alert

## Resources

* [Outscraper Website](https://outscraper.com)
* [Outscraper API Documentation](https://app.outscraper.com/api-docs)
* [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)

## Version History

### 0.2.8 (2026-04-30)
* Changed the refreshed n8n node type version to integer `2` so n8n accepts the updated resource options

### 0.2.7 (2026-04-30)
* Added node type version `1.1` so n8n refreshes the updated Outscraper resource list

### 0.2.6 (2026-04-30)
* Added Email Validator as a first-class Outscraper node resource
* Updated the lead generation example to use Outscraper credentials for email validation

### 0.2.5 (2026-04-30)
* Fixed the lead generation example normalizer to handle nested Outscraper response arrays such as `data: [[...businesses]]`

### 0.2.4 (2026-04-30)
* Added importable n8n workflow examples for lead generation, review sentiment analysis, and competitor monitoring
* Included the `examples` folder in the npm package

### 0.2.3 (2026-04-30)
* Added nested JSON schema builder support with path syntax
* Use dots for objects and `[]` for arrays, for example `products[].title`
* Supported building arrays of objects such as product lists with title, price, and description fields

### 0.2.2 (2026-04-30)
* Fixed AI Scraper request routing to use `POST /ai-scraper`
* Added optional JSON schema support with visual field builder and raw JSON modes
* Added `Use Schema` toggle so schema fields stay hidden until needed
* Updated AI Scraper request body to send `query`, `prompt`, `schema`, `async`, and `webhook`

### 0.2.1 (2026-02-19)
* New service AI Scraper

### 0.2.0 (2026-01-22)
* Fixed screenshot service

### 0.1.7 (2025-07-17)
* Added Emails & Contacts scraper

### 0.1.6 (2025-07-17)
* Fixed support for operations

### 0.1.5 (2025-06-27)
* Added support for geocoding operations (Geocode and Reverse Geocode)
* Enhanced operations with prices functionality
* Improved field configurations and routing options

### 0.1.4 (2025-06-26)

* Enhanced field configurations with additional parameters

### 0.1.3 (2025-06-26)

* Improved routing and display options

### 0.1.2 (2025-06-26)

* Refactored node structure for better maintainability
* Updated field configurations with improved descriptions
* Enhanced error handling and validation

### 0.1.1 (2025-06-25)

* Fixed minor bugs and improved stability
* Updated dependencies and documentation

### 0.1.0 (2025-06-25)

* Initial release
* Support for Google Maps, Google Search

## License

[MIT](LICENSE.md)
