{
  "slug": "youtube-takeout-stats",
  "name": "gizza-ai/youtube-takeout-stats",
  "version": "0.1.0",
  "title": "YouTube Takeout Stats — Watch History Analyzer — gizza.ai",
  "description": "Parse Google/YouTube Takeout watch-history JSON or HTML into top channels, repeated videos, monthly trends, weekdays, hours, streaks, CSV, and JSON.",
  "tags": [
    "youtube",
    "takeout",
    "watch history",
    "analytics",
    "stats",
    "csv",
    "json",
    "privacy"
  ],
  "category": "data",
  "urls": {
    "page": "https://gizza.ai/tools/youtube-takeout-stats/",
    "markdown": "https://gizza.ai/tools/youtube-takeout-stats/index.md",
    "descriptor": "https://gizza.ai/tools/youtube-takeout-stats/tool.json",
    "deep_link_example": "https://gizza.ai/tools/youtube-takeout-stats/?input=%5B%7B%22header%22%3A%22YouTube%22%2C%22title%22%3A%22Watched%20Never%20Gonna%20Give%20You%20Up%22%2C%22titleUrl%22%3A%22https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ%22%2C%22subtitles%22%3A%5B%7B%22name%22%3A%22Rick%20Astley%22%7D%5D%2C%22time%22%3A%222024-01-01T18%3A10%3A00Z%22%7D%5D&output=text&report=overview&top=10&utc_offset=0&include_ads=true&include_music=true&start_date=2024-01-01&end_date=2024-12-31"
  },
  "cli": "gizza tool youtube-takeout-stats '[{\"header\":\"YouTube\",\"title\":\"Watched Never Gonna Give You Up\",\"titleUrl\":\"https://www.youtube.com/watch?v=dQw4w9WgXcQ\",\"subtitles\":[{\"name\":\"Rick Astley\"}],\"time\":\"2024-01-01T18:10:00Z\"}]'",
  "tool": {
    "description": "Parse a Google/YouTube Takeout watch-history.json or watch-history.html export into local viewing statistics: totals, top channels, repeated videos, month trends, weekday and hour patterns, streaks, filters, CSV, and JSON. No YouTube API key, account login, or network lookup is used.",
    "parameters": {
      "additionalProperties": false,
      "properties": {
        "end_date": {
          "default": "",
          "description": "Optional inclusive end date in YYYY-MM-DD format. Leave blank to end at the last watch in the export.",
          "type": "string"
        },
        "include_ads": {
          "default": false,
          "description": "Include Google Ads impressions from the export. Off by default so ad rows do not inflate viewing totals.",
          "type": "boolean"
        },
        "include_music": {
          "default": false,
          "description": "Include YouTube Music watch rows. Off by default to keep the report focused on regular YouTube watch history.",
          "type": "boolean"
        },
        "input": {
          "description": "Contents of a Google/YouTube Takeout watch-history.json or watch-history.html export. The tool runs locally and never fetches YouTube or uploads the history.",
          "type": "string"
        },
        "output": {
          "default": "text",
          "description": "Output format: full text dashboard, CSV table for the selected report, or structured JSON.",
          "enum": [
            "text",
            "csv",
            "json"
          ],
          "type": "string"
        },
        "report": {
          "default": "overview",
          "description": "Report section to emit. Overview includes headline totals plus the channel, video, month, weekday, and hour tables.",
          "enum": [
            "overview",
            "channels",
            "videos",
            "months",
            "weekdays",
            "hours"
          ],
          "type": "string"
        },
        "start_date": {
          "default": "",
          "description": "Optional inclusive start date in YYYY-MM-DD format. Leave blank to start at the first watch in the export.",
          "type": "string"
        },
        "top": {
          "default": 10,
          "description": "Maximum ranked rows to include in the top channels and top videos reports, from 1 to 100.",
          "maximum": 100,
          "minimum": 1,
          "type": "integer"
        },
        "utc_offset": {
          "default": 0.0,
          "description": "Hours to add to JSON export timestamps before bucketing days and hours. Use your local UTC offset, such as -5 or 5.5. HTML exports are already local and ignore this value.",
          "maximum": 14,
          "minimum": -14,
          "type": "number"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}