Introduction

curl -X POST 'https://api.notion.com/v1/data_sources/<data_source_id>/query' \
  -H 'Authorization: Bearer <secret_bot>' \
  -H 'Notion-Version: 2026-03-11' \
  -H 'Content-Type: application/json' \
  --data '{
    "start_cursor": "33e19cb9-751f-4993-b74d-234d67d0d534"
  }'

import { Client, iteratePaginatedAPI } from "@notionhq/client";

const notion = new Client({
  auth: process.env.NOTION_API_KEY,
  notionVersion: "2026-03-11",
});

// Option 1: iterate one page of results at a time (async iterator)
for await (const page of iteratePaginatedAPI(
  notion.dataSources.query,
  { data_source_id: "<data_source_id>" }
)) {
  // Process each page result as it arrives
  console.log(page);
}

// Option 2: collect all results into an array
import { collectPaginatedAPI } from "@notionhq/client";

const allPages = await collectPaginatedAPI(
  notion.dataSources.query,
  { data_source_id: "<data_source_id>" }
);