Notion API

Beginner's Pick Documents & Productivity / OAuth Advanced HTTPS

78 B

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

The Notion API enables you to read and write pages, databases, and blocks in Notion workspaces programmatically. You can build integrations that sync data, automate content creation, or query structured databases. After creating an internal integration, you grant it access to specific pages, making setup straightforward.

Beginner Tip

After creating your integration at https://www.notion.com/my-integrations, remember to share the specific Notion page or database with it — without this sharing step, all API calls will return 404 even with a valid token.

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.

Use case: Integrate integrate with notion data into web and mobile applications

Notion 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 Notion",
    "description": "Integrate with Notion",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

object Type of the returned object such as page, database, block, or user.

id UUID of the Notion object (page, database, block, etc.).

properties Map of property names to their values for pages and database entries.

created_time ISO 8601 timestamp of when the page or block was created.

last_edited_time ISO 8601 timestamp of the most recent edit to the page or block.

url Direct URL to open the page in the Notion app or web interface.

Implementation Example

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

Request

const url = "https://developers.notion.com/docs/getting-started";
// 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.

401 Unauthorized The integration token is missing or malformed.

✓ Copy the Internal Integration Token from https://www.notion.com/my-integrations and pass it as a Bearer token.

404 Not Found on a valid page ID The integration was not given access to that page or database.

✓ Open the Notion page, click the three-dot menu, go to Connections, and add your integration.

400 Bad Request with validation errors The Notion-Version header is missing or outdated.

✓ Always include the Notion-Version: 2022-06-28 header in every request.

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

How is this scored? →