Create a Webset

Creates a new Webset with optional search, import, and enrichment configurations. The Webset will automatically begin processing once created.

You can specify an externalId to reference the Webset with your own identifiers for easier integration.

Request body

titlestring nullable

Optional name that appears anywhere the Webset is displayed. Leave empty to have Exa generate one automatically.

externalIdstring

The external identifier for the webset.

You can use this to reference the Webset by your own internal identifiers.

metadataobject

Set of key-value pairs you want to associate with this object.

{
  "search": {
    "query": "Marketing agencies based in the US, that focus on consumer products.",
    "count": 10
  }
}

Webset created

idstring required

The unique identifier for the webset

object'webset' required

status'idle' | 'pending' | 'running' | 'paused' required

The status of the webset

externalIdstring nullable required

The external identifier for the webset

titlestring nullable required

The title of the webset

metadataobject

Set of key-value pairs you want to associate with this object.

dashboardUrlstring uri required

The URL to view the webset in the Exa dashboard

createdAtstring date-time required

The date and time the webset was created

updatedAtstring date-time required

The date and time the webset was updated