Notion List Media icon

Notion List Media

List and retrieve media files from Notion blocks (v2.0.5)

Actions2

Page → List Media

AI-generated

Overview

The Notion List Media node lists and retrieves media files from a specified Notion page. It is useful for scenarios where users want to extract images, videos, audio, or files embedded within a Notion page for further processing or analysis. For example, a user might use this node to gather all media assets from a project documentation page in Notion to archive or repurpose them.

Use Case Examples

  1. Extract all images and videos from a Notion page to create a media gallery.
  2. Download audio files from a Notion page for offline listening.
  3. Filter and list only PDF files attached to a Notion page for review.

Properties

Name Meaning
Page ID The ID of the Notion page to list media from, required to identify the target page.
Options Additional options to filter and control the media listing, including media type filter, whether to include metadata, maximum number of results, and whether to download the media files as binary data.

Output

Binary

If 'Download Files' option is enabled, the node outputs media files as binary data encoded in base64 along with MIME type and file name.

JSON

  • id - Unique identifier of the media block.
  • type - General media type (image, video, audio, file).
  • blockType - Specific block type in Notion (e.g., image, video, audio, file, pdf).
  • url - URL to access the media file.
  • metadata
    • createdTime - Creation timestamp of the media.
    • lastEditedTime - Last edited timestamp of the media.
    • createdBy - User ID who created the media.
    • lastEditedBy - User ID who last edited the media.
    • caption - Caption text associated with the media, if any.
    • width - Width of the media block, if applicable.
    • height - Height of the media block, if applicable.
  • fileName - Name of the media file.
  • binary
    • data - Base64 encoded binary data of the media file (if downloaded).
    • mimeType - MIME type of the downloaded media file.
    • fileName - File name of the downloaded media file.

Dependencies

  • Requires an API key credential for Notion with upload media API access.

Troubleshooting

  • Invalid page ID error: Ensure the provided page ID is a valid UUID or properly formatted string.
  • HTTP request failures: Check network connectivity and API token validity.
  • Download failures: Media file URLs might be inaccessible or the server might reject the download request; verify permissions and URL correctness.

Links

Discussion