Skip to main content
POST
/
v1
/
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."
  }'

{
  "task_id": "<string>",
  "view_url": "<string>",
  "status": "queued",
  "webhook_url": "<string>"
}
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."
  }'

​
Advanced Example

Get webhook notifications and structured JSON output for easier parsing.
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",
    "task_spec": {
      "output_schema": {
        "type": "json",
        "json_schema": {
          "type": "object",
          "properties": {
            "developments": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "title": { "type": "string" },
                  "summary": { "type": "string" },
                  "source_url": { "type": "string" },
                  "category": { "type": "string", "enum": ["company", "research", "product"] }
                },
                "required": ["title", "summary", "source_url"]
              }
            }
          },
          "required": ["developments"]
        }
      }
    }
  }'

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?"

​
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"

​
task_spec
TaskSpec · object

Task specification with JSON output schema for structured results

Example:
{
  "output_schema": {
    "json_schema": {
      "properties": {
        "developments": {
          "items": {
            "properties": {
              "title": {
                "description": "Title of the development",
                "type": "string"
              },
              "summary": {
                "description": "Brief summary",
                "type": "string"
              },
              "source": {
                "description": "URL for more details",
                "type": "string"
              }
            },
            "required": ["title", "summary", "source"],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": ["developments"],
      "type": "object"
    },
    "type": "json"
  }
}
​
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