Skip to content
Nappai Documentation

Search (Notion)

This component lets you quickly find pages and databases within your Notion workspace that have been shared with Nappai. It uses the Notion API to perform the search, making it fast and efficient.

Relationship with Notion API

This component directly interacts with the Notion API to perform searches. You’ll need to connect your Notion account to Nappai to use this component. Nappai handles the technical details of communicating with the Notion API; you don’t need to know anything about APIs to use this search.

Inputs

  • Search Query: This is where you type the words you want to search for. Nappai will look for these words in the titles of your Notion pages and databases.
  • Filter Type: Choose whether you want to search only for “pages” or only for “databases”. The default is “pages”.
  • Sort Direction: Choose whether you want the results sorted in “ascending” (A-Z) or “descending” (Z-A) order. The default is “descending”.
  • Credential: This input is automatically handled by Nappai. It securely connects to your Notion account. You don’t need to interact with this directly.

Outputs

The component returns a list of results. Each result shows:

  • Title or URL: The name of the page or database.
  • Type: Whether it’s a page or a database.
  • Last Edited Time: When the page or database was last updated.
  • ID: A unique identifier for the page or database (this is useful for advanced users).

You can use these results to quickly navigate to the relevant Notion pages or databases within your workflow.

Usage Example

Let’s say you’re looking for a Notion database containing client information. You would:

  1. Enter “client information” in the Search Query field.
  2. Select “database” in the Filter Type dropdown.
  3. (Optional) Choose your preferred Sort Direction.
  4. Click the “Run” button (or equivalent in the Nappai dashboard).

Nappai will then display a list of matching Notion databases.

Templates

This component is used in many Nappai workflows and is often integrated into dashboards. Specific template examples are not listed here, but you’ll find it readily available in many automation flows.

Many components in Nappai can work with the output of this search. For example:

  • OpenAI Function Agent: Use the search results to generate text summaries or other content using OpenAI’s language models.
  • Google Sheet Writer: Export the search results to a Google Sheet.
  • Other Data Processing Components: Many other components in Nappai can process the structured data returned by this search.

Tips and Best Practices

  • Use specific keywords for better search results.
  • Experiment with different filter types and sort directions to refine your search.
  • If you’re not finding what you’re looking for, try different search terms.

Security Considerations

Nappai uses secure methods to connect to your Notion account and handle your data. Your Notion API key is securely stored and never directly exposed. Always ensure you are using the official Nappai application and not a third-party imitation.