Skip to main content
GET
/
v0
/
events
cURL
curl --request GET \
  --url https://api.exa.ai/websets/v0/events \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "object": "event",
      "type": "webset.created",
      "data": {
        "id": "<string>",
        "object": "<string>",
        "status": "idle",
        "externalId": "<string>",
        "title": "<string>",
        "searches": [
          {
            "id": "<string>",
            "object": "<string>",
            "status": "created",
            "websetId": "<string>",
            "query": "<string>",
            "entity": {
              "type": "<any>"
            },
            "criteria": [
              "<any>"
            ],
            "count": 2,
            "behavior": "override",
            "exclude": [
              "<any>"
            ],
            "scope": [
              "<any>"
            ],
            "progress": {
              "found": "<any>",
              "analyzed": "<any>",
              "completion": "<any>",
              "timeLeft": "<any>"
            },
            "recall": {
              "expected": "<any>",
              "reasoning": "<any>"
            },
            "metadata": {},
            "canceledAt": "2023-11-07T05:31:56Z",
            "canceledReason": "webset_deleted",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ],
        "imports": [
          {
            "id": "<string>",
            "object": "import",
            "status": "pending",
            "format": "csv",
            "entity": {
              "type": "<any>"
            },
            "title": "<string>",
            "count": 123,
            "metadata": {},
            "failedReason": "invalid_format",
            "failedAt": "2023-11-07T05:31:56Z",
            "failedMessage": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ],
        "enrichments": [
          {
            "id": "<string>",
            "object": "<string>",
            "status": "pending",
            "websetId": "<string>",
            "title": "<string>",
            "description": "<string>",
            "format": "text",
            "options": [
              "<any>"
            ],
            "instructions": "<string>",
            "metadata": {},
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ],
        "monitors": [
          {
            "id": "<string>",
            "object": "monitor",
            "status": "enabled",
            "websetId": "<string>",
            "cadence": {
              "cron": "<any>",
              "timezone": "<any>"
            },
            "behavior": {
              "type": "<any>",
              "config": "<any>"
            },
            "lastRun": {
              "id": "<any>",
              "object": "<any>",
              "status": "<any>",
              "monitorId": "<any>",
              "type": "<any>",
              "completedAt": "<any>",
              "failedAt": "<any>",
              "failedReason": "<any>",
              "canceledAt": "<any>",
              "createdAt": "<any>",
              "updatedAt": "<any>"
            },
            "nextRunAt": "2023-11-07T05:31:56Z",
            "metadata": {},
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ],
        "streams": [
          "<any>"
        ],
        "metadata": {},
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Your Exa API key

Query Parameters

​
cursor
string

The cursor to paginate through the results

Minimum length: 1
​
limit
number
default:25

The number of results to return

Required range: 1 <= x <= 200
​
types
enum<string>[]

The types of events to filter by

​
createdBefore
string<date-time>

Filter events created before or at this timestamp (inclusive). Must be a valid ISO 8601 datetime string. All times are in UTC.

​
createdAfter
string<date-time>

Filter events created after or at this timestamp (inclusive). Must be a valid ISO 8601 datetime string. All times are in UTC.

Response

200 - application/json

List of events

​
data
(WebsetCreatedEvent · object | WebsetDeletedEvent · object | WebsetIdleEvent · object | WebsetPausedEvent · object | WebsetItemCreatedEvent · object | WebsetItemEnrichedEvent · object | WebsetSearchCreatedEvent · object | WebsetSearchUpdatedEvent · object | WebsetSearchCanceledEvent · object | WebsetSearchCompletedEvent · object | ImportCreatedEvent · object | ImportCompletedEvent · object | MonitorCreatedEvent · object | MonitorUpdatedEvent · object | MonitorDeletedEvent · object | MonitorRunCreatedEvent · object | MonitorRunCompletedEvent · object)[]
required

The list of events

  • WebsetCreatedEvent
  • WebsetDeletedEvent
  • WebsetIdleEvent
  • WebsetPausedEvent
  • WebsetItemCreatedEvent
  • WebsetItemEnrichedEvent
  • WebsetSearchCreatedEvent
  • WebsetSearchUpdatedEvent
  • WebsetSearchCanceledEvent
  • WebsetSearchCompletedEvent
  • ImportCreatedEvent
  • ImportCompletedEvent
  • MonitorCreatedEvent
  • MonitorUpdatedEvent
  • MonitorDeletedEvent
  • MonitorRunCreatedEvent
  • MonitorRunCompletedEvent
​
hasMore
boolean
required

Whether there are more results to paginate through

​
nextCursor
string | null
required

The cursor to paginate through the next set of results

⌘I