Recombee GetItemValues icon

Recombee GetItemValues

GetItemValues operation from Recombee
Join our community

Overview

This node retrieves detailed values of items from a Recombee recommendation database. It is designed to fetch metadata or attributes associated with specific item IDs, which can be useful for enriching workflows with item information such as product details, descriptions, or custom properties stored in Recombee.

Common scenarios include:

  • Enriching user recommendations with additional item data.
  • Fetching item attributes to display or process further in automation workflows.
  • Integrating item metadata into reports or analytics pipelines.

For example, you might use this node to get the full details of a product by its ID before sending an email campaign or updating a CRM record.

Properties

Name Meaning
Item ID The unique identifier of the item whose values you want to retrieve from Recombee.
Max Retries Number of times to retry failed batch requests when fetching item values (default: 2).

Output

The node outputs an array of JSON objects, each corresponding to an input item. Each output object contains:

  • success: A boolean indicating if the request for that item succeeded.
  • itemId: The ID of the item requested.
  • itemData: The retrieved values/attributes of the item from Recombee (present only if successful).
  • error: Error message if the request failed (present only if unsuccessful).

If the node is configured to continue on failure, it will output both successes and failures; otherwise, it throws an error on the first failure.

No binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the Recombee service.
  • Needs configuration of the Recombee database ID, private token, and region via credentials.
  • Uses the official Recombee API client library (recombee-api-client).

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials will cause authentication errors.
    • Request timeouts or network issues may cause retries; increasing "Max Retries" can help.
    • Requesting non-existent item IDs will result in errors for those items.

  • Error messages:

    • Errors returned from Recombee are surfaced in the output under the error field.
    • If not continuing on fail, the node throws an error immediately on any failure.

  • Resolutions:

    • Verify API credentials and permissions.
    • Check item IDs for correctness.
    • Adjust retry count or timeout settings if experiencing transient network issues.

Links and References

Discussion