Create A Task

POST

research

tasks

curl --request POST \
  --url https://api.yutori.com/v1/research/tasks \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases."
  }'

import requests

response = requests.post(
    "https://api.yutori.com/v1/research/tasks",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "query": "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases."
    }
)
print(response.json())

const response = await fetch("https://api.yutori.com/v1/research/tasks", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    query: "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases."
  })
});
const data = await response.json();

{
  "task_id": "<string>",
  "view_url": "<string>",
  "webhook_url": "<string>"
}

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

curl --request POST \
  --url https://api.yutori.com/v1/research/tasks \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases."
  }'

import requests

response = requests.post(
    "https://api.yutori.com/v1/research/tasks",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "query": "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases."
    }
)
print(response.json())

const response = await fetch("https://api.yutori.com/v1/research/tasks", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    query: "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases."
  })
});
const data = await response.json();

Advanced Example

Receive structured output on a webhook when the task completes

Configure structured output with output_schema to receive data in a specific JSON schema format, and optionally add webhook notifications.

curl --request POST \
  --url https://api.yutori.com/v1/research/tasks \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases.",
    "user_timezone": "America/Los_Angeles",
    "webhook_url": "https://example.com/webhook",
    "output_schema": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": { "type": "string" },
          "summary": { "type": "string" },
          "source_url": { "type": "string" }
        }
      }
    }
  }'

import requests

response = requests.post(
    "https://api.yutori.com/v1/research/tasks",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "query": "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases.",
        "user_timezone": "America/Los_Angeles",
        "webhook_url": "https://example.com/webhook",
        "output_schema": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "title": {"type": "string"},
                    "summary": {"type": "string"},
                    "source_url": {"type": "string"}
                }
            }
        }
    }
)
print(response.json())

const response = await fetch("https://api.yutori.com/v1/research/tasks", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    query: "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases.",
    user_timezone: "America/Los_Angeles",
    webhook_url: "https://example.com/webhook",
    output_schema: {
      type: "array",
      items: {
        type: "object",
        properties: {
          title: { type: "string" },
          summary: { type: "string" },
          source_url: { type: "string" }
        }
      }
    }
  })
});
const data = await response.json();

Authorizations

x-api-key

string

header

required

Body

application/json

query

string

required

String describing the research task in natural language.

Example:

"What are the latest developments in quantum computing from the past week?"

output_schema

Output Schema · object | null

JSON Schema for structured output. Takes precedence over task_spec if both provided.

Example:

{
  "items": {
    "properties": {
      "title": {
        "description": "Title of the development",
        "type": "string"
      },
      "summary": {
        "description": "Brief summary",
        "type": "string"
      },
      "source_url": {
        "description": "URL for more details",
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

task_spec

TaskSpec · object | null

deprecated

Deprecated but still supported. Use output_schema instead.

Show child attributes

used_deprecated_task_spec

boolean

default:false

user_timezone

string

default:America/Los_Angeles

User's timezone for contextual awareness (e.g. 'America/Los_Angeles')

Example:

"America/Los_Angeles"

user_location

string | null

default:San Francisco, CA, US

User's coarse location in the format: city, region_code, country_name

Example:

"San Francisco, CA, US"

skip_email

boolean

default:true

If true, email notifications will be skipped and only webhook notifications will be sent.
    Default: true (sends webhooks only).

Example:

true

webhook_url

string | null

Optional webhook URL to receive results when the research task completes

Example:

"https://example.com/webhook"

webhook_format

enum<string>

default:scout

Webhook payload format. Slack incoming webhook URLs require 'slack'.

Available options:

scout,

slack,

zapier

Example:

"scout"

Response

Successful Response

Response for creating a research task.

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

webhook_url

string | null

Echoes the webhook URL configured for this task, if provided

Get Status And ResultsReturns the current status (queued, running, succeeded, failed) and any results if completed.

curl --request POST \
  --url https://api.yutori.com/v1/research/tasks \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases."
  }'

import requests

response = requests.post(
    "https://api.yutori.com/v1/research/tasks",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "query": "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases."
    }
)
print(response.json())

const response = await fetch("https://api.yutori.com/v1/research/tasks", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    query: "What are the latest developments in quantum computing from the past week? Include company announcements, research papers, and product releases."
  })
});
const data = await response.json();

{
  "task_id": "<string>",
  "view_url": "<string>",
  "webhook_url": "<string>"
}

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

Getting Started

General

Navigator API

Browsing API

Research API

Scouting API

Webhooks

Advanced Example

Authorizations

Body

Response

​Advanced Example

Authorizations

Body

Response

Advanced Example