Rate LimiterInstall

Summary

Throttle the processing of input items according to a selected rate limiting mode to avoid exceeding API rate limits or overwhelming downstream nodes.

Inputs

• Mode (required) — Select the rate limiting strategy: Fixed Delay, Requests Per Second, or Requests Per Minute.
• Delay Between Items (ms) — Milliseconds to wait between each item when in Fixed Delay mode.
• Max Requests Per Second — Maximum allowed requests per second when in Requests Per Second mode.
• Max Requests Per Minute — Maximum allowed requests per minute when in Requests Per Minute mode.
• Batch Size (required) — Number of items to process simultaneously before applying the delay, allowing bursts for some APIs.
• Add Metadata (required) — Whether to append debugging metadata (_rateLimiter info) to each output item.

Output shape

A list of output items identical to the input items with optional _rateLimiter metadata appended to each item's JSON data.

The node batches the input items according to the batch size, emitting the items immediately but inserting a calculated delay between batches based on the selected rate limiting mode. Metadata includes the item index, batch number, applied delay, mode, and processing timestamp when enabled.

Links

• n8n community nodes installation guide