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

# Proxy for N8N

> Call the NodeMaven API from an N8N HTTP Request node using your API key.

This guide shows how to connect N8N to the NodeMaven API with an HTTP Request node. For the endpoints themselves, see the [Proxy API overview](/proxy-api/overview).

## Step 1: Copy your API token

On your dashboard, go to **Profile** > **API Key**, then click **Copy Token** to copy your API key to the clipboard.

<Frame>
  <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1802328517/c2b5dccf6c883c0e0c33d2047f43/image.png" alt="NodeMaven dashboard profile menu with the API key and Copy Token control" />
</Frame>

## Step 2: Authorize the token

Open the **API Documentation** page and click the **Authorize** button. In the input field, enter your key in the following format:

```text theme={null}
x-api-key YOUR_API_KEY
```

Click **Authorize**, then **Close**.

<Frame>
  <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1802331115/39190673f7aa8ff5f5af5ba79be4/image.png" alt="API documentation Authorize dialog with the x-api-key value" />
</Frame>

## Step 3: Test the connection

Choose any **GET** endpoint from the API documentation, click **Try it out**, then **Execute**. If the setup is correct, you receive a `200 OK` response. If you encounter an error, double-check that your token is correctly authorized.

<Frame>
  <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1802333093/663510b25215baf35d19ab3c5acb/image.png" alt="API documentation showing a 200 OK response from a GET request" />
</Frame>

## Step 4: Set up N8N

On your N8N dashboard, click **Add First Step**, then select **HTTP Request** from the list of available nodes.

<Frame>
  <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1802334534/becf67fa40fdeeeb4c4cb0331f10/image.png" alt="N8N node picker with the HTTP Request node" />
</Frame>

## Step 5: Configure the request

Configure the HTTP Request node as follows:

* **Method:** `GET`
* **URL:** `https://api.nodemaven.com/api/v2/base/locations/countries/`

The URL above is an example that retrieves a list of countries. You can check the full API URLs in the [NodeMaven API documentation](https://dashboard.nodemaven.com/documentation/v2/swagger/), where you will also find other functions:

| Endpoint | Returns |
| - | - |
| `GET /api/v2/base/locations/countries/` | List of countries in a defined location |
| `GET /api/v2/base/locations/regions/` | List of regions in a defined location |
| `GET /api/v2/base/locations/cities/` | List of cities in a defined location |
| `GET /api/v2/base/locations/isps/` | List of ISPs in a defined location |
| `GET /api/v2/base/locations/zipcodes/` | List of zip codes in a defined location |
| `GET /api/v2/base/statistics/data/` | Data statistics |
| `GET /api/v2/base/statistics/requests/` | Requests statistics |
| `GET /api/v2/base/statistics/domains/` | Domains statistics |

Then enable the header toggle switch and add these two headers:

| Name | Value |
| - | - |
| `Authorization` | `x-api-key YOUR_API_KEY` |
| `Content-Type` | `application/json` |

## Step 6: Execute the request

Click **Execute Step**. You should see a list of all available countries, which confirms your N8N setup is complete and successfully connected to the API.

<Frame>
  <img src="https://downloads.intercomcdn.com/i/o/yvkc0rpk/1802339223/40cac7b7fce375022bfa89c22adf/image.png" alt="N8N HTTP Request node output showing the list of countries" />
</Frame>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.