DeepResearch

List DeepResearch tasks

Retrieve a list of all DeepResearch tasks for the authenticated API key.

get/v1/deepresearch/list

Request

  • Base URL: https://api.valyu.ai
  • URL: https://api.valyu.ai/v1/deepresearch/list
  • Auth: API key in header X-API-Key

Query parameters

limitinteger

Maximum number of tasks to return.

Response

List of DeepResearch tasks.

deepresearch_idstring required

Unique identifier for the research task.

querystring required

The original research query.

status'queued' | 'running' | 'completed' | 'failed' | 'cancelled' required

Current task status.

created_atstring date-time required

ISO 8601 timestamp of task creation.

publicboolean

Whether the task results are publicly accessible.

Example response

[
  {
    "deepresearch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "query": "CRISPR gene therapy clinical trials",
    "status": "completed",
    "created_at": "2024-06-15T10:30:00.000Z"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.