Research

List research runs

List saved research runs with optional filtering by status, query text, and date range. Cursors are only valid with the sort direction used to generate them.

get/v1/research-run

Request

  • Base URL: https://agent.tinyfish.ai
  • URL: https://agent.tinyfish.ai/v1/research-run
  • Auth: API key in header X-API-Key

Query parameters

status'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TIMED_OUT' | 'QUEUED'

Filter by research run status

Example:COMPLETED
querystring

Filter by query text (case-insensitive partial match)

Example:AI safety
created_afterstring date-time

Filter runs created after this ISO 8601 timestamp

Example:2026-01-01T00:00:00Z
created_beforestring date-time

Filter runs created before this ISO 8601 timestamp

Example:2026-02-01T00:00:00Z
sort_direction'asc' | 'desc'

Sort order by created_at

Example:desc
cursorstring

Cursor for pagination (from previous response). Must be replayed with the same sort_direction used to generate it.

limitinteger

Maximum number of results to return (1-100)

Example:20

Response

Paginated list of research runs

Example response

{
  "data": [
    {
      "research_run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "COMPLETED",
      "query": "What are the latest AI safety papers?",
      "deep_result": {
        "freshness_report": {
          "filter_applied": {
            "domain_type": "news",
            "after_date": "2024-01-01",
            "before_date": "2024-12-31",
            "recency_minutes": 60
          }
        }
      },
      "run_ids": [
        "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      ],
      "created_at": "2026-01-01T12:00:00Z",
      "completed_at": "2026-01-01T12:05:00Z"
    }
  ],
  "pagination": {
    "total": 142,
    "next_cursor": "eyJpZCI6ImFiYyIsImNyZWF0ZWRBdCI6IjIwMjYtMDEtMDFUMTI6MDA6MDBaIn0=",
    "has_more": true
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.