Actions16
Overview
The "Get Children" operation of the "Block" resource in this Notion Advanced node retrieves all child blocks of a specified block within a Notion workspace. This is useful when you want to programmatically explore or manipulate the hierarchical content structure inside a Notion page or block, such as extracting all sub-items under a heading or list.
Practical examples include:
- Fetching all paragraphs, images, or other content nested inside a toggle or callout block.
- Extracting the full content tree of a section for backup or transformation.
- Automating content analysis or migration by iterating through child blocks.
Properties
| Name | Meaning |
|---|---|
| Block ID | The unique identifier of the parent block whose children you want to retrieve. |
| Additional Fields | (Not applicable for this operation) |
Output
The output JSON contains an object with:
results: An array of child blocks retrieved from the specified parent block. Each block includes its type, content, properties, and potentially nested children.count: The total number of child blocks returned.
This output allows further processing or iteration over each child block's data.
Dependencies
- Requires a valid Notion API authentication token configured in n8n credentials.
- Uses Notion's official API endpoints to fetch block children.
- No additional external services are required beyond the Notion API.
Troubleshooting
- Invalid Notion API credentials: The node will throw an error if the provided API key/token is invalid or missing. Ensure your Notion integration token is correctly set up in n8n credentials.
- Block ID not found or invalid: If the specified Block ID does not exist or is malformed, the API request will fail. Verify the Block ID is correct and accessible by the integration.
- Empty children result: If the block has no children, the results array will be empty. This is expected behavior.
- API rate limits: Frequent requests may hit Notion API rate limits. Implement retry logic or reduce request frequency if encountering errors related to rate limiting.