Skip to main content
GET
/
v1
/
research
/
tasks
/
{task_id}
curl --request GET \
  --url https://api.yutori.com/v1/research/tasks/00000000-0000-0000-0000-000000000000-1234567890 \
  --header 'X-API-Key: YOUR_API_KEY'

{
  "task_id": "<string>",
  "view_url": "<string>",
  "status": "queued",
  "result": "<string>",
  "structured_result": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updates": [
    {
      "id": "<string>",
      "timestamp": 123,
      "content": "<string>",
      "citations": [
        {
          "id": "<string>",
          "url": "<string>",
          "preview_data": {}
        }
      ],
      "stats": {
        "num_tool_calls": 0,
        "num_mcp_tool_calls": 0,
        "num_crawler_calls": 0,
        "num_navigator_steps": 0,
        "num_websites_visited": 0,
        "sec_saved": 0
      },
      "structured_result": {}
    }
  ]
}
curl --request GET \
  --url https://api.yutori.com/v1/research/tasks/00000000-0000-0000-0000-000000000000-1234567890 \
  --header 'X-API-Key: YOUR_API_KEY'

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
task_id
string
required

Response

Successful Response

Response for getting research task status and results.

​
task_id
string
required

Unique identifier for this research task

​
view_url
string
required

URL to view task progress and results

​
status
enum<string>
required

Current status of the research task

Available options:
queued,
running,
succeeded,
failed
​
result
string | null

Research results in markdown format if completed

​
structured_result
Structured Result · object

If an output schema was provided, the result formatted as JSON matching that schema

​
created_at
string<date-time> | null

When the task was created

​
updates
Update · object[]

List of updates/results from the research task