Docs menu
Reference
Fetch functions
fetchBlocks and fetchPage, from notionic/fetch.
TypeScript
import { fetchBlocks, fetchPage } from "notionic/fetch"Returns Promise<NotionBlock[]>: every block under blockId, with nested blocks as children, linked pages and subpages as linkedPage, and previews of the pages behind bookmarks, embeds and link previews as bookmarkPreview.
Returns Promise<{ page: NotionPage; blocks: NotionBlock[] }>. page has id, url, title, icon, cover, lastEditedTime and properties.
| Option | Default | Description |
|---|---|---|
maxDepth | 5 | Levels of nested blocks to fetch below the top level. |
concurrency | 3 | Requests in flight at once per level. |
bookmarkPreviews | true | Fetch the page behind each bookmark, embed and link preview for its title, description, image and favicon, so they render as cards. false makes no requests outside Notion. |
client is a Client from @notionhq/client, or anything with the same blocks.children.list and pages.retrieve methods. Without pages.retrieve, fetchBlocks still works, but link to page blocks get no titles and subpages no icons.