Exa Websets icon

Exa Websets

Create, manage, and query structured datasets from web sources using Exa Websets API

Actions28

Overview

The node "Exa Websets" allows users to create, manage, and query structured datasets called websets from web sources using the Exa Websets API. Specifically, the List operation under the Webset resource retrieves multiple websets based on optional filters and pagination controls.

This node is beneficial when you want to programmatically access collections of web content aggregated into websets, for example:

  • Fetching all websets or a limited number of them for further processing.
  • Filtering websets by their external ID or status to focus on relevant datasets.
  • Integrating webset data retrieval into automated workflows for content analysis or monitoring.

Practical examples include:

  • Listing all active websets with status "running" to monitor ongoing data collection.
  • Retrieving a limited number of websets for display in a dashboard.
  • Filtering websets by an external identifier to sync with other systems.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit (boolean).
Limit Maximum number of results to return if not returning all (number, minimum 1).
Filters Collection of filters to narrow down the list of websets:
   External ID Filter websets by their external ID (string).
   Status Filter websets by their status. Possible values: Cancelled, Completed, Failed, Pending, Running.

Output

The output consists of JSON data representing the list of websets retrieved from the API. Each item in the output corresponds to a webset object containing its properties as returned by the Exa Websets API.

  • The json field contains the array or paginated list of websets matching the input criteria.
  • There is no indication that this node outputs binary data.

Dependencies

  • Requires an API key credential for authenticating with the Exa Websets API.
  • The base URL for API requests is https://api.exa.ai.
  • The node depends on the Exa Websets API service being available and accessible.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Common issues:

    • Authentication failures due to missing or invalid API credentials.
    • Network errors if the API endpoint is unreachable.
    • Invalid filter values causing the API to reject the request.
    • Request limits exceeded if too many items are requested without pagination.

  • Error messages:

    • "Unknown resource: ..." indicates an unsupported resource was selected.
    • Errors returned from the API will be surfaced in the node's error output if "Continue On Fail" is enabled.

  • Resolutions:

    • Verify API credentials and permissions.
    • Check network connectivity and API availability.
    • Ensure filter values conform to expected formats and allowed options.
    • Use the "Return All" toggle carefully to avoid large data requests.

Links and References

Discussion