Google Keep API

Development / OAuth Advanced HTTPS
Varies by plan (check documentation)

Overview

The Google Keep API allows applications to read and create notes in Google Keep, including text notes, lists, and notes with attachments. Access is controlled via OAuth 2.0 and is currently limited to Google Workspace accounts — it is not available for personal Google accounts. The API is primarily designed for enterprise use cases such as syncing notes with task management systems or knowledge bases.

💡

Beginner Tip

Note that the Google Keep API is only available to Google Workspace accounts, not personal Gmail accounts. You must enable it in Google Cloud Console and complete the OAuth 2.0 flow with the correct scope. If you are building for personal use, consider using the Google Tasks API instead, which has broader availability.

Available Data

Google Keep data via REST API
JSON-formatted response data
Requires OAuth authentication

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Google Keep",
    "description": "API to read, write, and format Google Keep notes",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

name Resource name of the note in the format notes/{note_id}.
createTime RFC 3339 timestamp of when the note was originally created.
updateTime RFC 3339 timestamp of the most recent modification to the note.
title The title of the note, if one was set.
body.text.text Plain text content of the note body.
trashed Indicates whether the note has been moved to trash.

Implementation Example

const url = "https://developers.google.com/keep/api/reference/rest";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

403 PERMISSION_DENIED The Google Keep API is not enabled for your project, or the authenticated account is a personal Google account.
Enable the Google Keep API in Google Cloud Console and use a Google Workspace account for testing.
401 Unauthorized The OAuth token is missing, expired, or does not include the keep scope.
Re-authenticate with the https://www.googleapis.com/auth/keep scope and refresh the token if expired.
404 Note not found The note name/ID provided does not exist or the user does not have access to it.
Use the notes.list endpoint first to retrieve valid note names before attempting to access individual notes.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 3/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Development
Difficulty Advanced
Verified: 2026-04-07

Similar APIs

View All →