Discuss Kit icon

Discuss Kit

Consume Discuss Kit API
Join our community

Actions66

Overview

This node integrates with the Discuss Kit API to perform search queries across various content types such as discussions, blogs, bookmarks, and documentation. It allows users to execute customized searches with options for hybrid search, exact matching, sorting, pagination, and inclusion of comments.

Typical use cases include:

  • Searching discussion threads or blog posts for specific keywords.
  • Retrieving bookmarked items matching certain criteria.
  • Querying documentation content to find relevant articles or sections.
  • Filtering results by relevance or recency, with control over how terms are matched.

For example, a user might search for all blog posts containing the term "API" sorted by relevance, or find recent discussions mentioning a particular feature.

Properties

Name Meaning
Query The search term to query (parameter q).
Type The type of content to search within. Options: Discussions, Blogs, Bookmarks, Docs.
Hybrid Search Whether to enable hybrid search mode (true/false).
Exact Match Whether to match the search term exactly (true/false).
Match Any Whether to match any of the search terms instead of all (true/false).
Include Whether to include the search term in results (true/false).
With Comments Whether to include comments in the search results (true/false).
Sort Sorting method for results. Options: Latest, Relevance.
Offset Number of results to skip for pagination purposes.
Limit Maximum number of results to return (minimum 1).

Output

The output is a JSON array where each item represents a search result matching the query parameters. Each result object contains fields relevant to the searched content type (discussion, blog, bookmark, or doc), including metadata such as titles, excerpts, IDs, and optionally comments if included.

No binary data output is produced by this node.

Dependencies

  • Requires access to the Discuss Kit API endpoint.
  • Optionally requires an API authentication token configured in n8n credentials to authorize requests.
  • Uses internal helper functions to make HTTP requests to the Discuss Kit API.

Troubleshooting

  • Empty Results: If no results are returned, verify that the search query (Query) is correctly specified and that the Type matches the content you expect to find.
  • Authentication Errors: Ensure that the API key or authentication token is properly configured in n8n credentials; otherwise, requests may fail.
  • Invalid Parameter Values: Check that numeric parameters like Offset and Limit are within valid ranges (e.g., Limit ≥ 1).
  • API Request Failures: Network issues or API downtime can cause errors; retry after some time or check API status.
  • Boolean Flags Misconfiguration: Flags like Hybrid Search, Exact Match, Match Any, and Include affect search behavior—incorrect combinations may yield unexpected results.

Links and References

Discussion