Read the events of an agent search

curl --request GET \
  --url https://api.crustdata.com/agent/searches/{search_id}/events \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-version: <x-api-version>'

import requests

url = "https://api.crustdata.com/agent/searches/{search_id}/events"

headers = {
    "x-api-version": "<x-api-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-api-version': '<x-api-version>', Authorization: 'Bearer <token>'}
};

fetch('https://api.crustdata.com/agent/searches/{search_id}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "search_id": "1318-07fcae93f67c961a96c8758766b2fea1",
  "events": [
    {
      "seq": 51,
      "data": {
        "run": 1,
        "state": "succeeded",
        "next_run": false,
        "completion": "answered"
      },
      "type": "run.finished",
      "message": "Run 1 finished: answered.",
      "version": 1,
      "search_id": "1318-07fcae93f67c961a96c8758766b2fea1",
      "created_at": "2026-11-13T11:32:44.442Z"
    },
    {
      "seq": 52,
      "data": {
        "state": "succeeded",
        "completion": "answered",
        "search": {
          "search_id": "1318-07fcae93f67c961a96c8758766b2fea1",
          "query": "The founders of Crustdata",
          "state": "succeeded",
          "created_at": "2026-11-13T11:32:26.860998+00:00",
          "output": {
            "note": null,
            "reason": null,
            "person": {
              "constraints": [
                {
                  "id": "c1",
                  "text": "Founded Crustdata.",
                  "importance": "hard"
                }
              ],
              "columns": [
                {
                  "key": "name",
                  "label": "Name",
                  "field": "basic_profile.name"
                },
                {
                  "key": "profile_url",
                  "label": "Profile URL",
                  "field": "social_handles.professional_network_identifier.profile_url"
                },
                {
                  "key": "basic_profile_headline",
                  "label": "Headline",
                  "field": "basic_profile.headline"
                }
              ],
              "rows": [
                {
                  "id": 1068035,
                  "values": {
                    "name": "Abhilash Chowdhary",
                    "profile_url": "https://www.linkedin.com/in/abhilashchowdhary",
                    "basic_profile_headline": "Co-founder at Crustdata (YC F24) | Infra for building AI employees"
                  },
                  "constraints": [
                    {
                      "constraint_id": "c1",
                      "assessment": "satisfied",
                      "evidence": "Headline identifies him as Crustdata co-founder, and current employer title is Co-Founder & CEO.",
                      "fields": [
                        "basic_profile.headline"
                      ]
                    }
                  ]
                }
              ]
            }
          },
          "credits_used": {
            "agent_cost": 0.66,
            "search_cost": 0.1385,
            "enrich_cost": 0,
            "contact_cost": 0,
            "total_cost": 0.7985
          },
          "error": null
        }
      },
      "type": "search.finished",
      "message": "Search finished: 3 people found.",
      "version": 1,
      "search_id": "1318-07fcae93f67c961a96c8758766b2fea1",
      "created_at": "2026-11-13T11:32:44.444Z"
    }
  ]
}

Read events

Read the progress events of a search after a cursor. Send the last seq you have as after, or as the Last-Event-ID header. With no cursor, you get every event from the first one.

The Accept request header picks the response:

application/json (the default; */* or no Accept header gives the same) returns one JSON object: the search_id and an events list of the events stored so far.
text/event-stream returns a stream that follows a running search to search.finished, or replays a search that has ended. Use the stream to resume a streaming start that broke.

search.finished is the last event. Its data.search is the search object, as GET /agent/searches/{search_id} returns it at that moment, with the charge in credits_used.

Default rate-limit is 300 requests per minute, shared by the read, events, and cancel routes.

GET

https://api.crustdata.com

agent

searches

{search_id}

events

Read the events of an agent search

curl --request GET \
  --url https://api.crustdata.com/agent/searches/{search_id}/events \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-version: <x-api-version>'

import requests

url = "https://api.crustdata.com/agent/searches/{search_id}/events"

headers = {
    "x-api-version": "<x-api-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-api-version': '<x-api-version>', Authorization: 'Bearer <token>'}
};

fetch('https://api.crustdata.com/agent/searches/{search_id}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "search_id": "1318-07fcae93f67c961a96c8758766b2fea1",
  "events": [
    {
      "seq": 51,
      "data": {
        "run": 1,
        "state": "succeeded",
        "next_run": false,
        "completion": "answered"
      },
      "type": "run.finished",
      "message": "Run 1 finished: answered.",
      "version": 1,
      "search_id": "1318-07fcae93f67c961a96c8758766b2fea1",
      "created_at": "2026-11-13T11:32:44.442Z"
    },
    {
      "seq": 52,
      "data": {
        "state": "succeeded",
        "completion": "answered",
        "search": {
          "search_id": "1318-07fcae93f67c961a96c8758766b2fea1",
          "query": "The founders of Crustdata",
          "state": "succeeded",
          "created_at": "2026-11-13T11:32:26.860998+00:00",
          "output": {
            "note": null,
            "reason": null,
            "person": {
              "constraints": [
                {
                  "id": "c1",
                  "text": "Founded Crustdata.",
                  "importance": "hard"
                }
              ],
              "columns": [
                {
                  "key": "name",
                  "label": "Name",
                  "field": "basic_profile.name"
                },
                {
                  "key": "profile_url",
                  "label": "Profile URL",
                  "field": "social_handles.professional_network_identifier.profile_url"
                },
                {
                  "key": "basic_profile_headline",
                  "label": "Headline",
                  "field": "basic_profile.headline"
                }
              ],
              "rows": [
                {
                  "id": 1068035,
                  "values": {
                    "name": "Abhilash Chowdhary",
                    "profile_url": "https://www.linkedin.com/in/abhilashchowdhary",
                    "basic_profile_headline": "Co-founder at Crustdata (YC F24) | Infra for building AI employees"
                  },
                  "constraints": [
                    {
                      "constraint_id": "c1",
                      "assessment": "satisfied",
                      "evidence": "Headline identifies him as Crustdata co-founder, and current employer title is Co-Founder & CEO.",
                      "fields": [
                        "basic_profile.headline"
                      ]
                    }
                  ]
                }
              ]
            }
          },
          "credits_used": {
            "agent_cost": 0.66,
            "search_cost": 0.1385,
            "enrich_cost": 0,
            "contact_cost": 0,
            "total_cost": 0.7985
          },
          "error": null
        }
      },
      "type": "search.finished",
      "message": "Search finished: 3 people found.",
      "version": 1,
      "search_id": "1318-07fcae93f67c961a96c8758766b2fea1",
      "created_at": "2026-11-13T11:32:44.444Z"
    }
  ]
}

Authorizations

Authorization

string

header

required

API key passed as a Bearer token in the Authorization header.

Headers

x-api-version

enum<string>

default:2025-11-01

required

API version to use. This endpoint currently requires 2025-11-01.

Available options:

2025-11-01

Example:

"2025-11-01"

Last-Event-ID

string

The same cursor as after, as an event-stream client sends it on a reconnect. It wins over after.

Path Parameters

search_id

string

required

The search_id that the start returned.

Example:

"1318-07fcae93f67c961a96c8758766b2fea1"

Query Parameters

after

integer

default:0

Return the events after this seq, a whole number from 0 to 2147483647. Default 0.

Required range: 0 <= x <= 2147483647

Response

The events after the cursor, as one list or as a stream.

The events after the cursor, oldest first.

search_id

string

required

Example:

"1318-07fcae93f67c961a96c8758766b2fea1"

events

object[]

required

Show child attributes

Example:

[
  {
    "seq": 2,
    "data": { "run": 1, "max_runs": 2 },
    "type": "run.started",
    "message": "Run 1 of 2 started.",
    "version": 1,
    "search_id": "1318-c379345672f34397a53fafff6dcfaa83",
    "created_at": "2026-11-13T11:32:55.583Z"
  }
]

API Reference

Company API

Person API

Web API

Job API

Watch API

Social Post API

Agent Search API

Batch API

Account API

Read events

Authorizations

Headers

Path Parameters

Query Parameters

Response