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

# n8n

> Install the n8n-nodes-cloro community node and query ChatGPT, Perplexity, Gemini, Copilot, Google AI Mode, and Google Search from any n8n workflow.

The cloro community node ([`n8n-nodes-cloro`](https://www.npmjs.com/package/n8n-nodes-cloro)) adds a **cloro** node to [n8n](https://n8n.io) that calls the [sync monitor endpoints](/guides/making-requests/sync) and returns parsed, structured results straight into your workflow. It's listed in the [n8n integrations directory](https://n8n.io/integrations/cloro/).

## Prerequisites

* A running n8n instance that allows community nodes (see the [n8n installation guide](https://docs.n8n.io/integrations/community-nodes/installation/))
* A cloro API key from the [dashboard](https://dashboard.cloro.dev) (see [Authentication](/guides/authentication))

## Install the node

In the n8n UI, go to **Settings → Community nodes → Install** and search for `n8n-nodes-cloro`. On a self-hosted instance you can also install it from the n8n installation directory:

```bash theme={null}
npm install n8n-nodes-cloro
```

## Configure credentials

Create a new **cloro API** credential and paste your API key. The node sends it on every request as a `Bearer` token in the `Authorization` header.

## Operations

| Operation       | Endpoint                                                            |
| --------------- | ------------------------------------------------------------------- |
| Monitor         | [`POST /v1/monitor/<provider>`](/guides/making-requests/sync)       |
| Get Countries   | [`GET /v1/countries`](/api-reference/endpoint/countries)            |
| Get Task Status | [`GET /v1/tasks/{taskId}`](/api-reference/endpoint/get-task-status) |

### Monitor

Pick a provider and the node calls the matching sync monitor endpoint:

* **Google Search** — query, country, city, device (desktop/mobile), number of pages, include AI Overview, include HTML, include markdown
* **ChatGPT** — prompt, country, include HTML, include markdown, include raw response, include search queries (query fan-out)
* **Google AI Mode, Google Gemini, Grok, Microsoft Copilot, Perplexity** — prompt, country, include HTML, include markdown

<Note>
  Grok is still selectable, but the provider is [temporarily unavailable](/guides/providers) — requests to it will fail until Grok access is restored.
</Note>

### Get Countries

Returns the supported countries, optionally filtered by provider — useful for validating country codes upstream in a workflow.

### Get Task Status

Checks the status of an [async task](/guides/making-requests/async) by its task ID, if you create tasks elsewhere and poll from n8n.

## Example: monitoring Google Search results

```text theme={null}
Node: cloro
Provider: Google Search
Operation: Monitor
Query: "best coffee shops in New York"
Country: United States
Device: Desktop
Pages: 2
Include AI Overview: true
Include Markdown: true
```

The node returns the same JSON as the [Google Search endpoint](/api-reference/endpoint/monitor-google) — organic results, People Also Ask, related searches, and the AI Overview when requested — ready to wire into filters, spreadsheets, or notifications.

<Note>
  Monitor calls run synchronously and count against your [concurrency limits](/guides/concurrency). Each call consumes credits at the standard per-provider rates — see [Providers](/guides/providers) and [Credits & limits](/guides/credits-and-limits).
</Note>