List deep-research jobs

GET/v1/research/jobs

Authorization

bearerAuth

AuthorizationBearer <token>

API token issued from the dashboard (Settings → API Tokens). Sent as Authorization: Bearer <token>.

In: header

Query Parameters

status?string

jobType?string

Value in"quick_search" | "quick_deep" | "full_deep" | "academic"

limit?integer

Default20

Range1 <= value <= 100

offset?integer

Default0

Range0 <= value <= 9007199254740991

Response Body

`application/json`

cURL

curl -X GET "https://example.com/research/jobs"

{
  "success": true,
  "jobs": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "jobType": "quick_search",
      "status": "pending",
      "query": "string",
      "progress": -9007199254740991,
      "currentStep": "string",
      "stepsCompleted": -9007199254740991,
      "stepsTotal": -9007199254740991,
      "findings": "string",
      "learnings": [
        "string"
      ],
      "citations": [
        {
          "text": "string",
          "url": "string",
          "title": "string"
        }
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "startedAt": "2019-08-24T14:15:22Z",
      "completedAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "limit": -9007199254740991,
    "offset": -9007199254740991
  }
}

{
  "error": "validation_failed",
  "message": "string",
  "issues": null
}

{
  "error": "unauthorized"
}

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`