Overview
This node integrates with the Valyu API to perform advanced search and content extraction operations. Specifically, the "Deepsearch" operation allows users to query a large dataset with customizable filters and parameters to retrieve relevant results based on their criteria. This is useful for scenarios such as research, market analysis, or any task requiring deep, filtered searches across multiple sources.
For example, a user might want to search for academic papers related to AI published within a certain date range, filtering by source domains and relevance thresholds. The node returns structured search results that can be further processed in an n8n workflow.
Properties
| Name | Meaning |
|---|---|
| Query | The search query string to find relevant documents or data. |
| Max Results | Maximum number of results to return (1 to 50). |
| Search Type | Type of search to perform: All, Web, or Proprietary sources only. |
| Max Price (CPM) | Maximum cost per thousand impressions (CPM) filter for the search. |
| Relevance Threshold (0–1) | Minimum relevance score threshold for returned results (between 0 and 1). |
| Included Sources (Comma/Newline Separated) | List of source domains to include in the search, separated by commas or newlines. |
| Excluded Sources (Comma/Newline Separated) | List of source domains to exclude from the search, separated by commas or newlines. |
| Category | Optional category filter for the search. |
| Response Length | Desired length of the response summary: Short, Medium, Large, or Max. |
| Country Code (ISO-2) | Optional ISO-2 country code to localize or filter results geographically. |
| Is Tool Call | Boolean flag indicating if the request is a tool call (affects API behavior). |
| Start Date (YYYY-MM-DD) | Optional start date to filter results from this date onward. |
| End Date (YYYY-MM-DD) | Optional end date to filter results up to this date. |
| Return | Choose between returning only the results array or the full API response object. |
Output
The node outputs JSON data representing the search results from the Valyu Deepsearch API. Depending on the "Return" property, it either returns:
- Results Array Only: An array of individual result objects containing details like title, snippet, source, relevance score, etc.
- Full API Response: The complete API response including metadata and other fields beyond just the results.
The output does not include binary data; it is purely JSON structured data suitable for further processing or direct use in workflows.
Dependencies
- Requires an API key credential for authenticating with the Valyu API.
- The node expects the API base URL to be configured in the credential.
- No additional external dependencies are required beyond the HTTP request capability provided by n8n.
Troubleshooting
Common Issues:
- Invalid or missing API credentials will cause authentication errors.
- Providing invalid date formats for start/end dates may lead to API rejections.
- Setting max results above 50 will be rejected due to API limits.
- Improperly formatted included/excluded sources (e.g., no trimming or empty entries) might affect filtering.
Error Messages:
- Authentication failures: Check that the API key credential is correctly set and valid.
- Validation errors from the API: Verify all input parameters conform to expected formats and ranges.
- Network or connectivity issues: Ensure n8n server has internet access and the API endpoint is reachable.
Links and References
- Valyu API Documentation (example placeholder link)
- n8n HTTP Request Node Documentation