Valyu icon

Valyu

Valyu Deepsearch & Contents

Actions2

Overview

This node integrates with the Valyu API to perform two main operations: Deepsearch and Contents (Extract/Summarize).

  • Deepsearch allows users to query a search engine that combines web and proprietary sources, filtering results by relevance, price, category, date range, and source inclusion/exclusion. It is useful for retrieving relevant documents or data points from a broad or specialized dataset.
  • Contents (Extract/Summarize) fetches content from specified URLs and optionally summarizes it using different modes including no AI summary, basic summary, custom prompt, or structured JSON schema. This operation is helpful for extracting and condensing information from web pages or documents.

Typical use cases include research automation, content aggregation, summarization of multiple web resources, and targeted data retrieval from mixed sources.

Properties

Name Meaning
Return Determines the output format:
- Results Array Only: Returns only the array of results.
- Full API Response: Returns the entire response object from the API.

Note: The provided input properties JSON defines only the "Return" property for this summary, but the node supports many other parameters depending on the selected operation (Deepsearch or Contents).

Output

The node outputs JSON data representing the API response:

  • If Return is set to "Results Array Only", the output is an array of result objects extracted from the API response's results field.
  • If Return is set to "Full API Response", the output includes the complete JSON response from the Valyu API.

The structure of each result depends on the operation:

  • For Deepsearch, results typically contain search hits with metadata such as relevance scores, source info, and content snippets.
  • For Contents, results include extracted content from URLs and any generated summaries.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Valyu API.
  • The API base URL is obtained from the credential and used to construct request endpoints.
  • The node makes HTTP POST requests to Valyu endpoints /v1/deepsearch or /contents.
  • No additional environment variables are required beyond the API credential.

Troubleshooting

  • Authentication errors: Ensure the API key credential is correctly configured and valid.
  • Invalid parameter values: Check that required fields like query (for Deepsearch) or urlsRaw (for Contents) are provided and properly formatted.
  • API rate limits or quota exceeded: May cause request failures; verify your Valyu account limits.
  • Malformed JSON in summary schema: When using structured summary mode, ensure the JSON schema is valid.
  • Empty or unexpected responses: Verify that filters and parameters (e.g., included/excluded sources, date ranges) are correct and that the query should return results.

If errors occur, the node throws detailed API error messages which can help identify issues.

Links and References

Discussion