Integration

heeb for n8n

The Heeb node runs the LLM Mentions API inside an n8n workflow. Give it a prompt, the brand to track and one or more models, and it submits the query, waits for every model to answer, then returns the per-model answer, its sources and citations, the ranked mentions it found, and the combined visibility and sentiment scores as workflow items.

Install on self-hosted n8n

  1. In n8n, open Settings, then Community Nodes.
  2. Choose Install.
  3. Enter the package name and confirm.
@heebai/n8n-nodes-heeb

Community nodes install on self-hosted n8n. The node is not available on n8n Cloud.

Connect your API key

  1. Add a Heeb API credential.
  2. Paste an API key from your dashboard. Every request carries it in the x-api-key header, and the credential test sends one call to confirm the key works.
  3. Leave Base URL at https://heeb.ai unless you route through your own proxy.
Get an API key

Submit Query

Submits one query and, with Wait for Completion on, returns the settled result. Jobs settle in 30 seconds to 2 minutes.

ParameterWhat it sets
PromptThe buyer question every model answers.
Entity NameThe brand to track inside those answers.
Entity URLThe official URL for that brand.
ModelsComma-separated model IDs. The sellable catalog changes over time, so take the current IDs from the pricing page.
Country CodeISO country code for the geographic context. Defaults to US.
Wait for CompletionOn by default: the node polls until the job settles and returns the whole result. Turn it off to get the job ID straight away.
TimeoutSeconds to keep polling before the node gives up. Defaults to 120.
Poll IntervalSeconds between result checks while polling. Defaults to 5.

Get Result

Fetches a job by its ID. It reports the job as pending while the models are still answering, and returns the aggregated result once the job settles.

ParameterWhat it sets
Job IDThe job ID that Submit Query returned.

What it costs

Running a query from the node costs the same as running it over the REST API.

See pricing

The package

@heebai/n8n-nodes-heeb is published on npm under the MIT license.

View on npm

Example workflow

A weekly schedule runs one query and posts to Slack when visibility drops below your threshold.

Download the JSON

Walkthrough

The blog post builds the workflow node by node and reads the scores it returns.

Read the post