> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> Web Scraping API node on n8n

[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform that lets you connect apps, APIs, and services to build automated workflows with minimal effort.

Decodo node provides an n8n integration for Decodo's Web Scraping API, a powerful web scraping tool that automatically bypasses blocks and bot protection to extract data from any target URL. It's designed for developers and startups looking to automate data collection workflows from platforms like Google, eCommerce sites, and job boards

Decodo n8n node integration is available with any [**Web Scraping API plan**](https://dashboard.decodo.com/register?page=scrapers/pricing?plan=907849)**.**

<Note>
  More information can be found on GitHub [here](https://github.com/Decodo/n8n-nodes-decodo).
</Note>

## Features

* **Easy integration**. Plug the Decodo's n8n node into existing workflows to start scraping with minimal setup.
* **Bypassing CAPTCHAs, rate-limits, and IP bans**. Automatic handling of common anti-bot defenses.
* **Geo-targeting**. Request region-specific results from websites that restrict content based on location.
* **Rotating proxy support to avoid IP bans**. Built-in proxy rotation to keep requests distributed and persistent.
* **Structured data output**. Get results in JSON or Markdown formats for easy readability and further analysis.

## Installation

Decodo is an official node integrated into n8n. To use it, simply:

1. Open the nodes panel.

<Frame>
  <img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/93a0241abf661effdf2542285794133df1e95aaee88367330ada1c4c47b45ea3-image.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=3ed9950e1debd55ac29a63114b5b0b9f" alt="" width="1586" height="722" data-path="images/docs/93a0241abf661effdf2542285794133df1e95aaee88367330ada1c4c47b45ea3-image.png" />
</Frame>

2. Search for "Decodo" to find the node.

<Frame>
  <img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/527ea98040e2983563916cbf24e16e2d4a07103eb29122a13d87d5ce34bd1d22-image.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=7a8971e568c23a1ee9f97125065f2974" style={{ width:"64%" }} className="mx-auto" width="758" height="406" data-path="images/docs/527ea98040e2983563916cbf24e16e2d4a07103eb29122a13d87d5ce34bd1d22-image.png" />
</Frame>

3. Click\*\* + Add to workflow.\*\*

<Frame>
  <img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/4cc139737c24ef4e391211462bfd8aa60ea988785d11c1c4acc22d4329d1d35a-image.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=b972901334a4af4e1758fb66e2d05936" style={{ width:"64%" }} className="mx-auto" width="768" height="662" data-path="images/docs/4cc139737c24ef4e391211462bfd8aa60ea988785d11c1c4acc22d4329d1d35a-image.png" />
</Frame>

### Obtaining a Decodo account

The node requires a[ Decodo Web Scraping API Advanced plan](https://decodo.com/scraping).

Once you have a plan activated, take a note of your generated authentication token from the [Web Scraping API page](https://dashboard.decodo.com/web-scraping-api/scraper):

<Frame>
  <img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/a2e78f3f22c408cb6566a4f6101f1958457f493b10ed0003ed28078063b34bc2-image.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=6e733ce2fd54a4aee877be81e80fd50d" alt="" width="794" height="293" data-path="images/docs/a2e78f3f22c408cb6566a4f6101f1958457f493b10ed0003ed28078063b34bc2-image.png" />
</Frame>

### Setting up credentials on n8n

1. Open the credentials window on n8n.

<Frame>
  <img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/96aea59afc217a80b7922d38880c987263ac7d16e1fa8ce37dea6f90d1e6fc4f-image.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=2ae69eecec7ba86ee6a368f75f5b4a09" style={{ width:"64%" }} className="mx-auto" width="1016" height="426" data-path="images/docs/96aea59afc217a80b7922d38880c987263ac7d16e1fa8ce37dea6f90d1e6fc4f-image.png" />
</Frame>

2. Create a new credential.

<Frame>
  <img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/b195ad042f52cf1d5bf3a9d09a45b72d9bfafc7fae1ccc97bb14eb2c5af2a0b2-image.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=2dec7a6c11e81b755fd8b4c7bd82ced4" style={{ width:"64%" }} className="mx-auto" width="444" height="266" data-path="images/docs/b195ad042f52cf1d5bf3a9d09a45b72d9bfafc7fae1ccc97bb14eb2c5af2a0b2-image.png" />
</Frame>

3. Find the Decodo Credentials API.

<Frame>
  <img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/54b31cff0bb65c264152bcf91fff9829a2312d470443a851a38c03a44d6b9c10-image.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=bf4726683b1a40068dfef99063c2b967" style={{ width:"64%" }} className="mx-auto" width="998" height="572" data-path="images/docs/54b31cff0bb65c264152bcf91fff9829a2312d470443a851a38c03a44d6b9c10-image.png" />
</Frame>

4. Enter your authentication token.

<Frame>
  <img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/b328d277557683a1eb18906efa93282517f2c6e2fdf240fd20eeb7552e0a5439-image.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=143fed08cdff0de16374280ef97cc87b" alt="" width="1052" height="369" data-path="images/docs/b328d277557683a1eb18906efa93282517f2c6e2fdf240fd20eeb7552e0a5439-image.png" />
</Frame>

## Using the node

The node can be used in 2 ways - as an individual HTTP request node, or a tool for an AI agent.

### Individual node

To use the Decodo node by itself, connect it to an existing workflow. Once you add it, you can set the target URL and Geolocation.

<Frame>
  <img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/5f32d252fac2c7f0cadd7fad4e03984f9160c0f597df56ea75b7a2a3d5ce6d42-image.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=580b414d09f0e069b9a00b69607a3b31" alt="" width="1372" height="868" data-path="images/docs/5f32d252fac2c7f0cadd7fad4e03984f9160c0f597df56ea75b7a2a3d5ce6d42-image.png" />
</Frame>

The node requests the target URL through a proxy in the chosen location, scrapes the page, and returns the response for use by downstream nodes, such as the HTML node to extract content. Below is an example setup:

<Frame>
  <img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/eecf90f5e83d0e0b6bcd47fb07ae510f35831c00993144367d0f21830d7fe234-image.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=fa2253593c0f92443e99eba3f8be5039" alt="" width="1440" height="466" data-path="images/docs/eecf90f5e83d0e0b6bcd47fb07ae510f35831c00993144367d0f21830d7fe234-image.png" />
</Frame>

### AI Agent tool

You can connect the Decodo node to the AI Agent node as a tool. You don't need to modify anything inside the node. Here's what a simple setup would look like:

<Frame>
  <img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/6c29d1960b2a3d88af99424c562d1fc9eac9e80744fb4af14c2370f7e60e5097-image.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=f35986b28c6b41f1d30a973fadf809ec" alt="" width="657" height="369" data-path="images/docs/6c29d1960b2a3d88af99424c562d1fc9eac9e80744fb4af14c2370f7e60e5097-image.png" />
</Frame>

With this setup, you can prompt the agent to scrape a website in order to extract information. The prompt must be detailed and specific to return the best results.

#### Bad prompt example

If your AI model does not have access to the most recent web information, the following question may fail:

> who won NBA in 2025?

#### Good prompt example

The question is more likely to be answered by updating the prompt with an instruction to scrape a reliable source:

> scrape wikipedia and tell me who won NBA in 2025

## Parameters

When used as an AI tool, the following parameters are inferred automatically from messages:

| Parameter  | Description                                                                                                                    | Example prompt                                                                                                     |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| `url`      | The target URL to scrape                                                                                                       | Scrape Wikipedia and tell me the article of the day.                                                               |
| `geo`      | The geographical location on which the result depends. [Read more](https://help.decodo.com/docs/web-scraping-api-localisation) | Scrape [https://ip.decodo.com/json](https://ip.decodo.com/json) and tell me what city the request originated from. |
| `markdown` | If set to result is in markdown format, otherwise result is in HTML format                                                     | Scrape [https://ip.decodo.com/json](https://ip.decodo.com/json) and return result in markdown format.              |

If used as an individual node, these parameters can be manually configured by double-clicking on the node.

## Compatibility

Node has been developed and tested with:

* Node.js v22.17.0
* n8n nodes API version 1
* n8n-workflow v1.82.0

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    Need help or just want to say hello? Our support is available 24/7. \
    You can also reach us anytime via email at [support@decodo.com](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>