{ "openapi": "3.0.1", "info": { "title": "NotebookLM API - Export Notebooks, Sources & Citations", "description": "Export your NotebookLM notebooks programmatically. Get conversations, source metadata with URLs, and citation mappings. Output to JSON, CSV, Markdown or Excel. Bulk export or select specific notebooks. Perfect for n8n workflows, RAG pipelines, or backups. Unlimited exports.", "version": "0.0", "x-build-id": "qAzYFlZPNrklitUf7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clearpath~notebooklm-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clearpath-notebooklm-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/clearpath~notebooklm-api/runs": { "post": { "operationId": "runs-sync-clearpath-notebooklm-api", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/clearpath~notebooklm-api/run-sync": { "post": { "operationId": "run-sync-clearpath-notebooklm-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "email", "appPassword" ], "properties": { "email": { "title": "Google Email", "type": "string", "description": "Your Google account email (e.g., your-email@gmail.com)" }, "appPassword": { "title": "App Password", "type": "string", "description": "NOT your Google password! Create one at myaccount.google.com/apppasswords (requires 2FA enabled). See README for details." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Set proxy country to match your Google account location (e.g., Germany if you're German). Mismatched countries may trigger Google login verification.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "projectIds": { "title": "Project IDs", "type": "array", "description": "UUIDs of specific notebooks to export. If empty, exports all notebooks up to the limit.", "items": { "type": "string" } }, "limit": { "title": "Notebook Limit", "minimum": 0, "type": "integer", "description": "Maximum number of notebooks to export. Set to 0 for unlimited.", "default": 10 }, "includeSourceSummaries": { "title": "Include Source Summaries", "type": "boolean", "description": "Fetch AI-generated summary and tags for each source. Note: This adds ~3 seconds per source to avoid rate limiting, so runs will take longer for notebooks with many sources.", "default": false }, "downloadAudioOverviews": { "title": "Download Audio Overviews", "type": "boolean", "description": "Download generated podcasts/audio overviews to the Key-Value store. The output will include a direct download URL for each audio file.", "default": false }, "downloadVideoOverviews": { "title": "Download Video Overviews", "type": "boolean", "description": "Download generated video overviews to the Key-Value store. The output will include a direct download URL for each video file.", "default": false }, "downloadSlideDecks": { "title": "Download Slide Decks", "type": "boolean", "description": "Download generated slide deck PDFs and individual slide images to the Key-Value store.", "default": false }, "downloadInfographics": { "title": "Download Infographics", "type": "boolean", "description": "Download generated infographic images to the Key-Value store.", "default": false }, "includeFlashCardContent": { "title": "Include Flash Card Content", "type": "boolean", "description": "Fetch the full content (questions and answers) for flash card artifacts. This requires an additional API call per flash card deck.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }