Skip to content
Nappai Documentation

Search

Searches all pages and databases that have been shared with an integration.

⚠️ DEPRECATION WARNING

This component is deprecated and will be removed in a future version of Nappai. Please migrate to the recommended alternative components.

How it Works

The Search component talks to the Notion API to look through every page and database that your integration has access to.
You can tell it whether you only want pages, only databases, or both by choosing a Filter Type.
A Search Query is the text you type in, and the component will return any titles that contain that text.
Finally, you can decide how the results are ordered with Sort Direction (e.g., newest first or oldest first).
All of this happens behind the scenes, so you just see a list of matching items in the dashboard.

Inputs

Input Fields

  • Filter Type: Choose whether the search should return only pages, only databases, or both.
  • Search Query: The keyword or phrase you want to find in page or database titles.
  • Sort Direction: Pick the order in which the results should appear (e.g., ascending or descending).

Credential
This component needs a Notion API credential.

  1. Go to the Credentials section of Nappai and create a new Notion API credential.
  2. Provide your Notion Integration Token (this is a secret key you get from Notion).
  3. In the component, select the credential you just created from the Credential dropdown.
    The token is stored securely by Nappai and is not shown in the component’s input list.

Outputs

  • Data: A structured list of pages and databases that match your search.
  • Tool: A helper object that can be used by other components to perform further actions on the search results.

Usage Example

  1. Drag the Search component onto your workflow.
  2. Set Filter Type to Pages.
  3. Enter Quarterly Report in Search Query.
  4. Choose Sort Direction as Ascending.
  5. Connect the Data output to a Table component to display the results in a grid.

The workflow will now show all pages titled with “Quarterly Report” in the order you specified.

  • NotionDirectoryLoader – Loads all pages and databases from a Notion workspace.
  • NotionPageRead – Retrieves the full content of a single Notion page.
  • NotionDatabaseQuery – Runs a query against a specific Notion database.

Tips and Best Practices

  • Keep your Search Query short and specific to reduce the number of results.
  • Use Filter Type to narrow down the search to only what you need (pages vs. databases).
  • If you need the newest items first, set Sort Direction to descending.
  • Remember that this component is deprecated; consider switching to the newer search alternatives when possible.

Security Considerations

  • The Notion Integration Token is a secret key; never expose it in public code or logs.
  • Nappai stores the token securely, but always double‑check that your credentials are not shared with unauthorized users.
  • When sharing a workflow that uses this component, ensure that the recipient also has the same Notion API credential set up.