Retrieve the notebook guide

September 29, 2026

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

Read what the Gemini Notebook web app shows at the top of a notebook, live from Google:

  • summary, Google’s overview of all the notebook’s sources, in Markdown.
  • suggestedReports, report topics Google proposes, each with the prompt that would write it. A prompt can be passed as instructions to POST /artifacts with type: "report" and format: "custom".
  • suggestedQuestions, questions to ask in chat, each with a short title and the full prompt. They are based on the sources whose status is ready, and the list is empty when there are none.

https://api.useapi.net/v1/gemini-notebook/notebooks/guide?notebook=notebook

Request Headers 
Authorization: Bearer {API token}
Query Parameters
  • notebook is required, the notebook id returned by POST /notebooks or GET /notebooks, for example user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55.
    The id names the account the notebook lives on, so no email parameter is needed. URL-encode it (it contains : and @).
Responses

  • 200 OK

    Summary shortened.

    {
  "notebook": "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55",
  "summary": "**Apollo 11** was the historic **American space mission** in July 1969 that successfully achieved the first **crewed lunar landing**. Propelled by a **Saturn V rocket** from the Kennedy Space Center, astronauts **Neil Armstrong**, **Buzz Aldrin**, and **Michael Collins** journeyed to the Moon...",
  "suggestedReports": [
    {
      "title": "How did the Space Race rivalry influence the mission's success?",
      "prompt": "Create a detailed briefing document designed to address this topic: \"How did the Space Race rivalry influence the mission's success?\". Include quotes from the original sources where appropriate."
    },
    {
      "title": "Tell me about the challenges during the Eagle's lunar descent.",
      "prompt": "Create a detailed briefing document designed to address this topic: \"Tell me about the challenges during the Eagle's lunar descent.\". Include quotes from the original sources where appropriate."
    }
  ],
  "suggestedQuestions": [
    {
      "title": "Mission Timeline",
      "prompt": "Create a chronological narrative of the mission events from launch to safe splashdown."
    },
    {
      "title": "Astronaut Perspective",
      "prompt": "Focus on the experience of the crew including the challenge of lunar surface operations."
    }
  ]
}

  • 400 Bad Request

    {
  "error": "Parameter notebook is required",
  "code": 400
}

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "useapi.net ⁝ Unauthorized",
  "code": 401
}

  • 403 Forbidden

    The id was issued to a different API token.

    {
  "error": "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55 does not belong to this API token",
  "code": 403
}

  • 404 Not Found

    The notebook was deleted, or its account is no longer configured.

    {
  "error": "Not found on account [email protected] (Google rLM1Ne grpc 5)",
  "code": 404
}

  • 596 Account Error

    Google reported the account as signed out. While we re-check it, the answer is the first message below. Retry in about a minute. If it stays signed out, the account is paused, you receive an email, and the answer becomes the second message until you re-add it via Setup Gemini Notebook.

    {
  "error": "Google reported this account as signed out. We are re-checking it — please retry in about a minute. If it stays signed out, you will receive a re-add email.",
  "code": 596
}

    {
  "error": "Account [email protected]: Google signed this account out. Re-add it at https://useapi.net/docs/start-here/setup-gemini-notebook",
  "code": 596
}

  • 503 Service Unavailable

    Google is temporarily unavailable or is challenging our network. Retry in a few minutes. A 502 means Google answered with an unexpected error.

    {
  "error": "Google is temporarily unavailable (VfAZjd grpc 14), please retry",
  "code": 503
}
Model 
{ // TypeScript, all fields are optional
  notebook: string
  summary: string | null       // Markdown
  suggestedReports: {
    title: string
    prompt: string
  }[]
  suggestedQuestions: {        // [] when no source is ready
    title: string
    prompt: string
  }[]
  error: string                // error responses only
  code: number                 // error responses only, the HTTP status
}
Examples 
  • curl -G "https://api.useapi.net/v1/gemini-notebook/notebooks/guide" \
   -H "Authorization: Bearer …" \
   --data-urlencode "notebook=user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55"

  • const token = "API token";
const notebook = "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55";
const apiUrl = `https://api.useapi.net/v1/gemini-notebook/notebooks/guide?notebook=${encodeURIComponent(notebook)}`;
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
notebook = "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55"
apiUrl = "https://api.useapi.net/v1/gemini-notebook/notebooks/guide"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers, params={"notebook": notebook})
print(response, response.json())
Try It