JigsawStack icon

JigsawStack

Use JigsawStack API

Actions20

Overview

The node integrates with the JigsawStack API to perform a web search based on a user-provided query. It allows users to customize the search by enabling AI-powered overviews, safe search filtering, spell checking, specifying URLs to prioritize, and toggling a deep research mode for more thorough results.

This node is beneficial in scenarios where automated, enriched web search results are needed within an n8n workflow, such as gathering information for content creation, market research, or monitoring online mentions. For example, a marketing team could use it to automatically fetch and summarize recent news articles about a competitor, or a researcher might use it to collect and analyze web data relevant to a specific topic.

Properties

Name Meaning
Query The search query string (up to 400 characters) to find relevant web results.
AI Overview Whether to include an AI-generated summary overview of the search results.
Safe Search Level of filtering for offensive content in results; options: Moderate, Strict, Off.
Spell Check Whether to enable automatic spell checking of the search query before execution.
BYO URLs An array of specific URLs to prioritize or restrict the search results to these sources.
Deep Research Toggle to enable a deeper, more comprehensive research mode for the search.
Deep Research Config JSON configuration object for deep research mode, including parameters like max depth, breadth, and token limits.

Output

The node outputs JSON data containing the search results returned from the JigsawStack API. This includes:

  • The list of web search results matching the query.
  • If enabled, an AI-generated overview summarizing the results.
  • Metadata related to the search such as applied filters and any deep research details.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the JigsawStack API.
  • The node sends requests to https://api.jigsawstack.com/v1.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key will cause authentication failures.
    • Exceeding query length limit (400 characters) may result in errors.
    • Malformed JSON in the Deep Research Config property can cause request failures.
    • Network connectivity issues to the JigsawStack API endpoint.
  • Error Messages:

    • Authentication errors typically indicate invalid or missing API credentials.
    • Validation errors may occur if required properties like "Query" are empty.
    • JSON parsing errors if the Deep Research Config is not valid JSON.
  • Resolutions:

    • Ensure the API key credential is correctly set up and active.
    • Validate input fields, especially the query length and JSON format.
    • Test network access to the API endpoint outside n8n to rule out connectivity problems.

Links and References

Discussion