> For the complete documentation index, see [llms.txt](https://docs.scraperapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scraperapi.com/integrations/automation-and-workflow-integrations/n8n-integration.md). # n8n Integration Our [n8n node](https://n8n.io/integrations/scraperapi/) allows you to integrate ScraperAPI into your workflows. Send API request directly from n8n and use the scraped data directly into your automation. We handle the heavy lifiting in the background: **proxy/user-agent rotation**, **CAPTCHA and Bot-Blocker bypass**, **rendering** (when necessary), so you can focus on building efficient and reliable data workflows. {% hint style="success" %} **Looking for pre-built workflows?** Browse the official [ScraperAPI templates on n8n](https://n8n.io/integrations/scraperapi/) to see popular automations, such as daily price-drop digests for Amazon, Walmart and Google that you can import and adapt so you don't have to start from scratch. {% endhint %} ### Installation **Grab your ScraperAPI API Key:** 1. Sign up for a ScraperAPI account at [ScraperAPI Dashboard](https://dashboard.scraperapi.com/signup). 2. Once logged in, navigate to your dashboard. 3. Copy your API key from the dashboard. Add the `ScraperAPI` Node **inside n8n:** 1. Log into n8n. 2. Open an existing workflow or create a new one. 3. Click the **`+`** button (Add Node) on the canvas. 4. In the search bar, type ScraperAPI. 5. Select the ScraperAPI node from the list. 6. The node will be added directly to your workflow. #### How it works **Scraping Workflow** 1. Add a **ScraperAPI** node to your workflow. 2. Select the **API** resource. 3. Enter the **URL** you want to scrape. 4. Configure any optional parameters (see available [Parameters](https://github.com/scraperapi/n8n-nodes-scraperapi-official/blob/master/README.md#parameters)). 5. Execute the workflow. The node returns the scraped content.
#### AI Chat Model Scraping Workflow Integrating an AI Chat Model into your workflow unlocks prompt-driven scraping, allowing you to scrape using natural language. 1. Add a **Chat Message Received** trigger. 2. Add an **AI Agent** node. 3. Connect an **AI Chat Model** (e.g. OpenAI) node to the Agent (Chat Model input). 4. Connect a **Simple Memory** node to the Agent (Memory input). 5. Connect the **ScraperAPI** node to the Agent (Tool input). 6. Add a **system prompt** to the **AI Agent** explaining how it should behave. The rest of the workflow is use-case-based.
### Resources #### API Endpoint The **API** resource allows you to scrape any website using ScraperAPI's endpoint. It supports: * JavaScript rendering for dynamic content. * Geo-targeting with country codes. * Device-specific user agents (desktop/mobile). * Premium and ultra-premium proxy options. * Automatic parsing of structured data for select websites. | Parameter | Parameter Type | Description | | ----------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `URL` | REQUIRED | The target URL to scrape (e.g., `https://example.com`) | | `COUNTRY_CODE` | OPTIONAL | Two-letter ISO country code (e.g., `US`, `GB`, `DE`) for geo-targeted scraping. | | `Device Type` | OPTIONAL |

Choose the device type to scrape the page as:
- Desktop: Standard desktop browser user agent.
- Mobile: Mobile device user agent.

| | `RENDER` | OPTIONAL | Enable JavaScript rendering for pages that require JavaScript to load content. Set to `true` only when needed, as it increases processing time. | | `PREMIUM` | OPTIONAL | Use premium residential/mobile proxies for higher success rates. This option costs more but provides better reliability. **Note**: Cannot be combined with Ultra Premium. | | `ULTRA_PREMIUM` | OPTIONAL | Activate advanced bypass mechanisms for the most difficult websites. This is the most powerful option for sites with advanced anti-bot protection. **Note**: Cannot be combined with Premium. | | `OUTPUT_FORMAT` | OPTIONAL |

The output\_format parameter allows you to instruct the API on what the response file type should be. Valid options:

SDEs valid options:

| | `AUTOPARSE` | OPTIONAL |

Activate auto parsing for selected websites by setting autoparse=true. The API will parse the data on the page and return it in JSON format.

This parameter does not increase the cost of the API request.

| | `ZIP` | OPTIONAL | Specify a **US ZIP** code for Amazon location-specific results (Amazon US only, e.g., `92223`). | | `SESSION_NUMBER` | OPTIONAL | Reuse the same proxy session across requests. **Note**: cannot be combined with Premium or Ultra Premium. | | `KEEP_HEADERS` | OPTIONAL |

Send custom headers/cookies with your requests. Currently only supported through the HTTP Request Node.
Note: does not work with Ultra Premium.

| | `FOLLOW_REDIRECT` | OPTIONAL | Follow redirects. Enabled by default (`true`). Set to `false` to receive the redirect response instead of the final URL. | | `RETRY_404` | OPTIONAL | Retry requests that return a `404` status code, useful for pages that intermittently return 404s. **Note**: not available with Premium or Ultra Premium. | #### MCP Server ScraperAPI also provides an **MCP (Model Context Protocol) server** that enables AI models and agents to scrape websites. #### Hosted MCP Server ScraperAPI offers a hosted MCP server that you can use with n8n's [MCP Client Tool](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/). **Configuration Steps:** 1. Add an **MCP Client Tool** node to your workflow 2. Configure the following settings: * **Endpoint**: `https://mcp.scraperapi.com/mcp` * **Server Transport**: `HTTP Streamable` * **Authentication**: `Bearer Auth` * **Credential for Bearer Auth**: Enter your ScraperAPI API key as a Bearer Token. * **Tools to include**: `All` (or select specific tools as needed) #### Self-Hosted MCP Server If you prefer to self-host the MCP server, you can find the implementation and setup instructions in the [scraperapi-mcp repository](https://github.com/scraperapi/scraperapi-mcp). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.scraperapi.com/integrations/automation-and-workflow-integrations/n8n-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.