Tool

Fetch

Notion-Fetch is a powerful AI tool designed to retrieve detailed information from Notion pages or databases using their URLs or IDs. It enables users to seamlessly access and view Notion content, including pages and multi-source databases, in an enhanced Markdown format for easy integration and use.

Notion

Features

  • Supports fetching Notion pages by URL or UUID (with or without dashes).
  • Retrieves detailed information from Notion databases, including multi-source data collections.
  • Returns content in an enhanced Markdown format, surpassing standard syntax for rich text representation.
  • Supports multiple calls to fetch several Notion entities simultaneously.
  • Provides detailed metadata of pages and their associated database views for accurate data retrieval.

Benefits

  • Simplifies access to specific Notion content without manual navigation.
  • Improves workflow efficiency by integrating Notion data retrieval into AI tools or applications.
  • Enables comprehensive project and data management by exposing detailed page and database info.
  • Supports complex Notion setups, including multi-source databases and various views.
  • Ensures consistent, structured content output suitable for developers and content creators.

Description

Retrieves details about a Notion entity by its URL or ID. You can fetch the following types of entities:

  • Page, i.e. from a <page> block or a <mention-page> mention
  • Database, i.e. from a <database> block or a <mention-database> mention Use the "fetch" tool when you need to see the details of a Notion entity you already know exists and have its URL or ID. Provide the Notion entity's URL or ID in the id parameter. You must make multiple calls to the "fetch" tool if you want to fetch multiple entities. Content for pages that are returned use the enhanced Markdown format, which is a superset of the standard Markdown syntax. See the full spec in the description of the "create-pages" tool. Databases can have multiple data sources, which are collections of pages with the same schema. When fetching a database, the tool will return information about all its data sources. NOTE regarding multi-source databases: If your input URL looks like: https://notion.so/workspace/26c104cd477e80059141c7ed3bce2ce6?v=26c104cd477e818ca439000c4500cf98 The UUID before the '?v=' is the database ID, and the UUID after the '?v=' is the specific view ID. All views and data sources are included in the response, but views can be associated with a specific data source, so you may be able to narrow down which data source the URL refers to based on the fetch response. Continuing the example of fetching the above URL, if the response looks like the following, then the URL is associated with the data source collection://26c104cd-477e-805f-95d7-000b4340f82f. This can be helpful if the user provides the complete URL and wants to find pages in that data source; the search tool requires a specific data source ID. <snippet description="Partial fetch response for a multi-source database">
<view url="{{view://26c104cd-477e-818c-a439-000c4500cf98}}"> {"dataSourceUrl":"{{collection://26c104cd-477e-805f-95d7-000b4340f82f}}","name":"","properties":["Name","Number"],"type":"table"} </view> </snippet> <example description="Fetch a page by URL"> {"id": "https://www.notion.so/workspace/Product-Requirements-1234567890abcdef"} </example> <example description="Fetch a page by ID (UUIDv4 with dashes)"> {"id": "12345678-90ab-cdef-1234-567890abcdef"} </example> <example description="Fetch a page by ID (UUIDv4 without dashes)"> {"id": "1234567890abcdef1234567890abcdef"} </example> <example description="Fetch a database"> {"id": "https://www.notion.so/workspace/Projects-Database-abcdef1234567890"} </example> <common-use-cases> - "What are the product requirements still need to be implemented from this ticket https://notion.so/page-url?" - "Show me the details of the project database at this URL" - "Get the content of page 12345678-90ab-cdef-1234-567890abcdef" </common-use-cases>

Parameters

1 parameter

NameTypeDescription
idrequiredstring

The ID or URL of the Notion page to fetch

Try Needle today

Streamline AI productivity at your company today

Join thousands of people who have transformed their workflows.

Agentic workflowsAutomations, meet AI agents
AI SearchAll your data, searchable
Chat widgetsDrop-in widget for your website
Developer APIMake your app talk to Needle
    Needle LogoNeedle
    Like many websites, we use cookies to enhance your experience, analyze site traffic and deliver personalized content while you are here. By clicking "Accept", you are giving us your consent to use cookies in this way. Read our more on our cookie policy .