Recombee ListItemsInstall

Overview

This node performs the "ListItems" operation using the Recombee API, which is a recommendation engine service. It retrieves multiple items from a Recombee database in batches, handling retries for failed requests. This node is useful when you want to fetch item data from Recombee for further processing or analysis within an n8n workflow.

Common scenarios include:

• Synchronizing item data from Recombee into another system.
• Fetching item details to personalize content or recommendations.
• Batch processing of item metadata for reporting or enrichment.

Example: You might use this node to retrieve all product items from your Recombee database to update your e-commerce platform's catalog or to analyze item popularity.

Properties

Output

The node outputs an array of JSON objects, each representing the result of a batch request for listing items. Each output item contains:

• success: A boolean indicating whether the request succeeded.
• If successful:
  • The original input data merged with an itemData field containing the item details returned by Recombee.
• If failed:
  • An error field describing the failure.
  • The original input data related to the failed request.

If the node is configured to continue on failure, it collects all results including errors; otherwise, it throws an error immediately upon failure.

No binary data is output by this node.

Dependencies

• Requires an API key credential for authenticating with the Recombee service.
• Uses the Recombee API client library (recombee-api-client) to communicate with the Recombee API.
• Needs configuration of credentials including:
  • Database ID
  • Private token
  • Region
  • Optional API timeout setting

Troubleshooting

• Common issues:

  • Network or authentication failures when connecting to Recombee.
  • Exceeding rate limits or timeouts causing batch requests to fail.
  • Improperly configured credentials leading to authorization errors.

• Error messages:

  • Errors returned from the Recombee API will be included in the output if "continue on fail" is enabled.
  • Without "continue on fail," the node will throw an error on the first failure.

• Resolutions:

  • Verify that the API credentials are correct and have sufficient permissions.
  • Adjust the "Max Retries" property to allow more retry attempts for transient errors.
  • Check network connectivity and Recombee service status.
  • Increase the API timeout in credentials if requests frequently time out.

Links and References

• Recombee API Documentation
• n8n Documentation on Creating Nodes