# Notion API

**Provider:** Notion
**Category:** storage
**Base URL:** `https://api.notion.com/v1`
**Auth:** bearer — `Authorization: Bearer secret_...
Notion-Version: 2022-06-28`
**Rate Limit:** 3 requests/sec per integration
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developers.notion.com

## Description

The Notion API allows external integrations to read and write Notion content. Query and filter database entries (rows), create and update pages, manipulate block content (text, code, embeds, images), manage page properties, search across workspaces, and handle comments. Used to build CMS integrations, project tracking tools, content pipelines, and data sync applications. Requires a Notion integration with appropriate workspace permissions.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://api.notion.com/v1/databases/{database_id}/query` | Query and filter database entries |
| POST | `https://api.notion.com/v1/pages` | Create a new page in a database or as a subpage |
| PATCH | `https://api.notion.com/v1/pages/{page_id}` | Update page properties |
| GET | `https://api.notion.com/v1/blocks/{block_id}/children` | Get child blocks (content) of a page or block |
| POST | `https://api.notion.com/v1/search` | Search across all accessible pages and databases |
| GET | `https://api.notion.com/v1/databases/{database_id}` | Get database schema and properties |

## Authentication

Create an internal integration at notion.so/my-integrations. Share your Notion pages/databases with the integration. Pass the Integration Token as a Bearer token.

```
Authorization: Bearer secret_...
Notion-Version: 2022-06-28
```

## Sample Request

```bash
curl "https://api.notion.com/v1/databases/$NOTION_DB_ID/query" \
  -H "Authorization: Bearer $NOTION_TOKEN" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"filter":{"property":"Status","select":{"equals":"In Progress"}},"sorts":[{"property":"Created","direction":"descending"}]}'
```

## Sample Response

```json
{
  "results": [{
    "id": "page-uuid-here",
    "properties": {
      "Name": { "title": [{ "plain_text": "Launch API Map" }] },
      "Status": { "select": { "name": "In Progress" } },
      "Priority": { "select": { "name": "High" } }
    }
  }]
}
```

## Pricing Details

Free: unlimited personal pages, limited collaboration. Plus: $10/user/mo. Business: $15/user/mo. Enterprise: custom.

---

*Source: [API Map](https://apimap.dev/apis/notion/) — CC BY 4.0*