Summaries

curl "https://api.daily-tube.com/v1/summaries?q=telescope&maxResults=5" \
  -H "Authorization: Bearer dtk_YOUR_KEY"

const url = new URL("https://api.daily-tube.com/v1/summaries");
url.searchParams.set("q", "telescope");
url.searchParams.set("maxResults", "5");
const res = await fetch(url, { headers: { Authorization: "Bearer dtk_YOUR_KEY" } });

import urllib.request, json, urllib.parse

url = "https://api.daily-tube.com/v1/summaries?" + urllib.parse.urlencode({"q": "telescope", "maxResults": 5})
req = urllib.request.Request(url, headers={"Authorization": "Bearer dtk_YOUR_KEY"})
with urllib.request.urlopen(req) as r:
    print(json.load(r)["data"]["items"])

{
  "data": {
    "items": [
      {
        "id": "7f3a…91",
        "expected_datetime": "2026-10-25T14:00:00Z",
        "created_at": "2026-10-25T14:02:11Z",
        "headline": "Space digest weekly",
        "dek": "Orbital roundup",
        "language": "english",
        "section_count": 2,
        "success": true,
        "is_saved": true,
        "is_shared": true,
        "short_id": "a1b2c3d4",
        "match_field": "story"
      }
    ],
    "pageInfo": { "totalResults": 3, "resultsPerPage": 5, "page": 1, "totalPages": 1 },
    "searchInfo": { "suggestions": [ { "query": "telescopes", "result_count": 2, "summary_ids": ["7f3a…91"] } ] }
  },
  "request_id": "5f0c…"
}

{
  "data": {
    "id": "7f3a…91",
    "state": "completed",
    "expected_datetime": "2026-10-25T14:00:00Z",
    "created_at": "2026-10-25T14:02:11Z",
    "language": "english",
    "trigger_type": "automatic",
    "headline": "Space digest weekly",
    "dek": "Orbital roundup",
    "tags": ["space"],
    "plain_text": "# Space digest weekly\n\n…",
    "sections": [
      {
        "emoji": "🛰",
        "category": "News",
        "summary": "…",
        "importance_score": 4,
        "plain_text": "…",
        "sources": [ { "content_id": "…", "content_title": "…", "source_type": "youtube", "included": true } ]
      }
    ],
    "delivery": {
      "delivered_at": "2026-10-25T14:05:00Z",
      "channels": [ { "type": "email", "success": true } ]
    },
    "share": { "is_shared": true, "short_id": "a1b2c3d4", "url": "https://daily-tube.com/s/a1b2c3d4", "view_count": 12 },
    "is_saved": true
  },
  "request_id": "5f0c…"
}

{
  "data": {
    "id": "7f3a…91",
    "state": "in_progress",
    "started_at": "2026-10-26T09:00:00Z",
    "progress": {
      "overall_percent": 55,
      "retrieval": { "status": "completed", "percent": 100 },
      "generation": { "status": "stage4", "percent": 10, "label": "writing" }
    }
  },
  "request_id": "5f0c…"
}

{
  "data": {
    "id": "7f3a…91",
    "state": "skipped_no_new_content",
    "reason": "No new content since your last briefing",
    "finished_at": "2026-10-25T14:01:00Z",
    "delivery": { "delivered_at": "2026-10-25T14:05:00Z", "channels": [] }
  },
  "request_id": "5f0c…"
}

curl -X POST https://api.daily-tube.com/v1/summaries/7f3a…91 \
  -H "Authorization: Bearer dtk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"share"}'

const res = await fetch("https://api.daily-tube.com/v1/summaries/7f3a…91", {
  method: "POST",
  headers: { Authorization: "Bearer dtk_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ action: "share" }),
});
const { data } = await res.json();
console.log(data.url); // the public /s/{short_id} link

import urllib.request, json

body = json.dumps({"action": "share"}).encode()
req = urllib.request.Request(
    "https://api.daily-tube.com/v1/summaries/7f3a…91",
    data=body,
    headers={"Authorization": "Bearer dtk_YOUR_KEY", "Content-Type": "application/json"},
)
with urllib.request.urlopen(req) as r:
    print(json.load(r)["data"])

{
  "data": { "short_id": "a1b2c3d4", "url": "https://daily-tube.com/s/a1b2c3d4", "is_shared": true, "reused": false },
  "request_id": "5f0c…"
}

{
  "error": { "code": "summary.not_found", "message": "Summary not found" },
  "request_id": "5f0c…"
}