Query

deepResearchReports

List the Deep Research reports in the current workspace, newest first.

MCP: getDeepResearchReports

Arguments

Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

after String: The endCursor of the previous page.
filter DeepResearchReportFilterInput: Narrow the list.
status DeepResearchReportStatus: Only reports in this lifecycle status.
CANCELLED: Stopped before it finished; it will not complete.
COMPLETED: Finished: shareUrl is set, and deepResearchReport(id:) returns its markdown.
FAILED: Stopped by an error; errorMessage says why.
FETCHING: Reading the posts it will analyze.
PENDING: Created, not started yet.
PROCESSING: Analyzing them and writing the report. A report also reads PROCESSING when an earlier version of Deep Research left it paused between fetching and analysis, or when it is in a step this list does not name separately; check running, which is false for the paused case. The PROCESSING filter matches neither case.
first Int default 20: Page size, 1 to 100. Keep it the same while paging with after.

Returns

Returns DeepResearchReportPage!.

nodes [DeepResearchReport!]!: The reports on this page.
completedAt DateTimeWithZone: When it completed; null while running or after a failure.
createdAt DateTimeWithZone: When the report was created.
errorMessage String: Why a failed report failed.
id ID!: Report UUID. Pass it to deepResearchReport(id:) to poll it.
inputType DeepResearchInputType: The source kind it ran on; null when Deep Research did not say or the source is not one of the DeepResearchInputType kinds.
BRAND: Tracked competitor brands (brandIds), including your own brand, over a date window.
CAMPAIGN: A campaign (campaignId): the report reads the campaign's content.
CREATOR: A creator (creatorId, optionally narrowed to socialProfileIds).
VIEW: A saved content view (viewId): the report reads the posts the view matches.
markdown String: The finished report as Markdown. Returned by deepResearchReport(id:) only, once the report has completed; null in deepResearchReports and while it runs.
phase String: The step a running report is on.
postsAnalyzed Int: How many posts it read.
progressMessage String: Human-readable progress of a running report.
running Boolean!: Whether Deep Research still lists the report as in flight; poll until it is false. False for COMPLETED, FAILED and CANCELLED, and for a PROCESSING report an earlier version of Deep Research left paused. It follows the status Deep Research holds, not whether work is happening: a report that stalls in flight stays true until Deep Research fails or cancels it, so cap how long you poll, for example by giving up once createdAt is hours old.
shareUrl String: Public link to the finished report; null until it completes.
sourceId String: Id of the source it ran on.
sourceName String: Name of the source it ran on.
status DeepResearchReportStatus!: Lifecycle status: PENDING, FETCHING and PROCESSING are in flight; COMPLETED, FAILED and CANCELLED are final. A report can also read PROCESSING while it is in a step this list does not name separately. Use running, not the status, to decide whether to keep polling.
CANCELLED: Stopped before it finished; it will not complete.
COMPLETED: Finished: shareUrl is set, and deepResearchReport(id:) returns its markdown.
FAILED: Stopped by an error; errorMessage says why.
FETCHING: Reading the posts it will analyze.
PENDING: Created, not started yet.
PROCESSING: Analyzing them and writing the report. A report also reads PROCESSING when an earlier version of Deep Research left it paused between fetching and analysis, or when it is in a step this list does not name separately; check running, which is false for the paused case. The PROCESSING filter matches neither case.
templateSlug String: The template the report ran.
title String: The report title, as the Archive app shows it.
pageInfo PageInfo!: Pass endCursor as after for the next page while hasNextPage is true.
endCursor String: Cursor for the last node in this page.
hasNextPage Boolean!: Whether there are more results after this page.
hasPreviousPage Boolean!: Whether there are results before this page.
startCursor String: Cursor for the first node in this page.
totalCount Int!: Reports matching the filter, across all pages.

Open in explorer ↗

Values are sampled from a demo workspace — substitute your own token and workspace id.

Page through the workspace's Deep Research reports, newest first, whoever started them.

query.graphql

query DeepResearchReportsDefault($first: Int) {
  deepResearchReports(first: $first) {
    nodes {
      id
      status
      running
      title
      templateSlug
      inputType
      sourceName
      createdAt
      completedAt
      shareUrl
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}

variables.json

{
  "first": 10
}

Headers

Authorization: Bearer docs_demo_token_0000000000000000000000
WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a

Request · cURL

curl https://app.archive.com/api/v2 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer docs_demo_token_0000000000000000000000' \
  -H 'WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a' \
  -d '{
  "query": "query DeepResearchReportsDefault($first: Int) {\n  deepResearchReports(first: $first) {\n    nodes {\n      id\n      status\n      running\n      title\n      templateSlug\n      inputType\n      sourceName\n      createdAt\n      completedAt\n      shareUrl\n    }\n    pageInfo {\n      hasNextPage\n      endCursor\n    }\n    totalCount\n  }\n}",
  "variables": {
    "first": 10
  }
}'

Request · Node.js

const response = await fetch("https://app.archive.com/api/v2", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer docs_demo_token_0000000000000000000000",
    "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
  },
  body: JSON.stringify({
    query: `query DeepResearchReportsDefault($first: Int) {
  deepResearchReports(first: $first) {
    nodes {
      id
      status
      running
      title
      templateSlug
      inputType
      sourceName
      createdAt
      completedAt
      shareUrl
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}`,
    variables: {
      "first": 10
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  query DeepResearchReportsDefault($first: Int) {
    deepResearchReports(first: $first) {
      nodes {
        id
        status
        running
        title
        templateSlug
        inputType
        sourceName
        createdAt
        completedAt
        shareUrl
      }
      pageInfo {
        hasNextPage
        endCursor
      }
      totalCount
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "first" => 10 } }.to_json,
  "Content-Type" => "application/json",
  "Authorization" => "Bearer docs_demo_token_0000000000000000000000",
  "WORKSPACE-ID" => "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
)
puts response.body

Request · Python

import json
import requests

query = """
query DeepResearchReportsDefault($first: Int) {
  deepResearchReports(first: $first) {
    nodes {
      id
      status
      running
      title
      templateSlug
      inputType
      sourceName
      createdAt
      completedAt
      shareUrl
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"first": 10}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK 25 lines

{
  "data": {
    "deepResearchReports": {
      "nodes": [
        {
          "id": "5d0c3f1e-8a42-4b7e-9c61-2f8e4a9b7d13",
          "status": "COMPLETED",
          "running": false,
          "title": "Share of Voice: Northwind Botanicals vs Verdant Co. and Rootbound",
          "templateSlug": "share-of-voice",
          "inputType": "BRAND",
          "sourceName": "Verdant Co.",
          "createdAt": "2024-12-31T10:00:00Z",
          "completedAt": "2024-12-31T10:06:00Z",
          "shareUrl": "https://deep-research.archive.com/r/5d0c3f1e-8a42-4b7e-9c61-2f8e4a9b7d13"
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": null
      },
      "totalCount": 1
    }
  }
}