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

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

Google Keep data via REST API

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative
{
  "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

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
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

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

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.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Development
Difficulty Advanced
Listing details not endpoint-verified

Similar APIs

View All →