List notes

September 29, 2026

Table of contents

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

List every note of one notebook, read live from Google. Notes are the notebook’s own notepad: the ones written with POST /notes or in the Gemini Notebook web app, and chat answers saved to a note in the web app.

Each note carries a type:

type Note
note A note written by hand or with POST /notes
saved_answer A chat answer saved as a note in the web app. Its content keeps the answer’s citation markers such as [1]
mindmap A mind map made with POST /notes/mindmap or in the web app. Its content is the mind map as a JSON string, a tree of { name, children } nodes

A type Google adds later is returned as type<N>, with Google’s number.

https://api.useapi.net/v1/gemini-notebook/notes?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

    A notebook without notes returns "notes": [].

    {
  "notebook": "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55",
  "notes": [
    {
      "note": "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55:e5514ee8-22e5-414d-aa67-86e8476ece09",
      "title": "Landing timeline",
      "content": "Powered descent began at 102:33 GET.",
      "type": "note",
      "created": "2026-09-29T04:08:58.000Z",
      "updated": "2026-09-29T04:08:58.000Z"
    }
  ]
}

  • 400 Bad Request

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

  • 401 Unauthorized

    Invalid API token.

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

  • 403 Forbidden

    The notebook 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 cFji9 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, retry shortly. A 502 means Google answered with an unexpected error.

    {
  "error": "Google is temporarily unavailable (cFji9 grpc 14), please retry",
  "code": 503
}
Model 
{ // TypeScript, all fields are optional
  notebook: string
  notes: {
    note: string               // user:<id>-<email>-note:<notebook uuid>:<note uuid>
    title: string
    content: string            // the note's text
    type: string               // note | saved_answer | mindmap
    created?: string           // ISO 8601. Google moves it to the edit time when the content changes
    updated?: string           // ISO 8601
  }[]
  error: string                // error responses only
  code: number                 // error responses only, the HTTP status
}
Examples 
  • curl -G "https://api.useapi.net/v1/gemini-notebook/notes" \
   -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/notes?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/notes"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers, params={"notebook": notebook})
print(response, response.json())
Try It