List Research Tasks - Yutori API

GET

research

tasks

curl --request GET \
  --url https://api.yutori.com/v1/research/tasks \
  --header 'X-API-Key: YOUR_API_KEY'

import requests

response = requests.get(
    "https://api.yutori.com/v1/research/tasks",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(response.json())

const response = await fetch("https://api.yutori.com/v1/research/tasks", {
  method: "GET",
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await response.json();

{
  "tasks": [
    {
      "task_id": "<string>",
      "query": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "view_url": "<string>"
    }
  ],
  "total": 0,
  "filtered_total": 0,
  "summary": {
    "running": 123,
    "succeeded": 123,
    "failed": 123
  },
  "page_size": 123,
  "has_more": false,
  "prev_cursor": "<string>",
  "next_cursor": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Returns research tasks for the authenticated user. Each task includes lightweight metadata including task_id, status, creation time, and dashboard URL. Supports optional cursor-based pagination and status filtering. If page_size is not provided, returns all research tasks. Use status=succeeded to list tasks with retrievable results. Status is computed from stored task state without a live workflow lookup, so running also covers queued tasks and tasks whose workflow has already failed but isn’t yet reconciled. Call GET /v1/research/tasks/{task_id} for the authoritative queued/running/succeeded/failed status of a single task.

curl --request GET \
  --url https://api.yutori.com/v1/research/tasks \
  --header 'X-API-Key: YOUR_API_KEY'

import requests

response = requests.get(
    "https://api.yutori.com/v1/research/tasks",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(response.json())

const response = await fetch("https://api.yutori.com/v1/research/tasks", {
  method: "GET",
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await response.json();

Pagination and Filtering

Use cursor-based pagination to fetch tasks in batches, with optional filtering by status.

cURL

curl --request GET \
  --url 'https://api.yutori.com/v1/research/tasks?page_size=20&status=succeeded' \
  --header 'X-API-Key: YOUR_API_KEY'

Query Parameters

Parameter	Type	Description
`page_size`	integer	Number of tasks per page. If omitted, returns all tasks.
`cursor`	string	Cursor from a previous response for pagination.
`status`	string	Filter by status: `running`, `succeeded`, or `failed`.

Authorizations

x-api-key

string

header

required

Query Parameters

status

enum<string> | null

Filter by task status: running, succeeded, or failed.

Available options:

running,

succeeded,

failed

page_size

integer | null

cursor

string | null

Response

Successful Response

tasks

TaskListItem · object[]

required

Show child attributes

total

integer

default:0

Total count of all tasks (running + succeeded + failed)

filtered_total

integer

default:0

Count of tasks matching the current filter

summary

TaskListSummary · object | null

Counts by status

Show child attributes

page_size

integer | null

Requested page size (null if returning all)

has_more

boolean

default:false

Whether more results exist after this page

prev_cursor

string | null

Cursor for previous page

next_cursor

string | null

Cursor for next page

Create A TaskLaunches a one-time research task on the web.

curl --request GET \
  --url https://api.yutori.com/v1/research/tasks \
  --header 'X-API-Key: YOUR_API_KEY'

import requests

response = requests.get(
    "https://api.yutori.com/v1/research/tasks",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(response.json())

const response = await fetch("https://api.yutori.com/v1/research/tasks", {
  method: "GET",
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await response.json();

{
  "tasks": [
    {
      "task_id": "<string>",
      "query": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "view_url": "<string>"
    }
  ],
  "total": 0,
  "filtered_total": 0,
  "summary": {
    "running": 123,
    "succeeded": 123,
    "failed": 123
  },
  "page_size": 123,
  "has_more": false,
  "prev_cursor": "<string>",
  "next_cursor": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

​Pagination and Filtering

​Query Parameters

Authorizations

Query Parameters

Response

Pagination and Filtering

Query Parameters