Skip to Content
SourcesNotion

Notion

Notion

Scan Notion pages, data sources, comments, and file attachments.

Category
Collaboration
Source type
NOTION
Produces
pagedata_sourcefilecomments

Notion is a wiki, a database and a file cabinet at once, which is why it tends to hold a bit of everything — hiring notes, vendor contracts, a table of API keys someone made “temporarily”.

What you need to connect

An integration token. Create an internal integration in Notion, copy its secret, then share the pages and databases you want scanned with it — Notion integrations see nothing by default. An OAuth access token works too.

That sharing step is also your scope control: the integration can only read what someone deliberately gave it.

What Classifyre reads

  • Pages — the text of the page’s blocks.
  • Data sources (databases) — their schema, with their row pages linked.
  • Comments — page and block comments, as one comments asset per page.
  • Files — attachments, images, PDFs and video blocks, page icons and covers, materialised as their own assets.
  • Links between pages — parent, relation and mention references, wired into the graph.

Narrow further by page id, data source id, or a search query.

Files attached in Notion are read with the shared file pipeline: see Supported File Formats for everything it can open, and OCR & Transcription for reading text out of images, audio and video.

Metadata on every asset

Asset kind · page

FieldTypeAlways presentWhat it is
page_idstringYesNotion page id
titlestringYesTitle of the page
links_countintegerYesNumber of linked or related assets
parent_typestringNoParent object type
parent_idstringNoParent object id
statusstringNoStatus from properties
tagsstring[]NoMulti-select property values

Asset kind · data_source

FieldTypeAlways presentWhat it is
data_source_idstringYesNotion data source id
namestringYesData source name
row_countintegerYesNumber of rows
columnsobject[]NoColumns as {name, type} objects (Notion property name and type)
parent_typestringNoParent object type
parent_idstringNoParent object id

Asset kind · file

FieldTypeAlways presentWhat it is
selectorstringYesSelector for the file within the page
namestringYesFile name
is_externalbooleanYesWhether the file is externally hosted

Asset kind · comments

FieldTypeAlways presentWhat it is
comments_countintegerYesNumber of comments
page_idstringYesParent page id

Lineage

Lineage

This source records no lineage. Nothing in the system it reads describes data moving from one place to another, so no FLOW edges are produced. Related items are still linked — see Lineage & Relationships for what those links mean and how they differ from lineage.

Worth knowing

  • Nothing shared, nothing scanned. An empty scan almost always means the integration hasn’t been given access to any pages yet.
  • Rate limits are respected with retries and an optional fixed delay.

Configuration

Beyond the fields below, every source also has the settings shared by all of them: the sampling strategy, the detectors to run, the scan schedule, and the compute limits for its scan jobs.

Required

Without these, the source will not save.

FieldTypeRequiredWhat it doesDefault
requiredobjectYesNotion has no required connection fields; the integration token lives in the masked section.no extra properties

Secrets

Stored encrypted and never shown again after you save them. See Configuration & Fields.

FieldTypeRequiredWhat it doesDefault
maskedobjectYesno extra properties
notion_tokenstringYesNotion API token used as a Bearer credential. Accepts an internal integration secret (ntn_...) or an OAuth public-integration access token.

Optional

Everything you can tune. Sensible defaults apply when you leave them alone.

FieldTypeRequiredWhat it doesDefault
optionalobjectNono extra properties
connectionobjectNoHTTP, version, and retry settings for Notion API calls.no extra properties
connection.max_retriesintegerNoMaximum retry attempts for transient API failures and rate limitsmin 0, max 103
connection.notion_versionstringNoNotion-Version header sent with every request. Defaults to the data-sources API version.2025-09-03
connection.rate_limit_delay_secondsnumberNoAdditional delay between API requests to reduce rate-limit pressuremin 00
connection.request_timeout_secondsnumberNoHTTP request timeout for Notion API callsmin 130
contentobjectNoNotion content extraction controls.no extra properties
content.file_max_bytesintegerNoMaximum bytes downloaded per file for MIME inference and text extractionmin 10245242880
content.include_commentsbooleanNoInclude page and block comments and aggregate them into a per-page comments assettrue
content.include_data_sourcesbooleanNoEmit Notion data sources (databases) as assets with their schema and link their row pagestrue
content.include_filesbooleanNoMaterialize files from file/image/pdf/video blocks, file properties, and page icon/cover as related assetstrue
content.include_linked_pagesbooleanNoWire parent, relation, and mention references between pages into the asset links graphtrue
scopeobjectNoOptional Notion scope filters. When omitted, all content shared with the integration is eligible for sampling.no extra properties
scope.data_source_idsarrayNoRestrict extraction to specific data source IDs (up to 250)max items 250
scope.data_source_ids[]stringNo
scope.page_idsarrayNoRestrict extraction to specific page IDs (up to 250)max items 250
scope.page_ids[]stringNo
scope.search_querystringNoOptional full-text query passed to the Notion search endpoint to narrow discoverymin length 1
Last updated on