> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newport.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search: Find Anything Across Your Workspace Quickly

> Google's powerful search lets you instantly find projects, records, users, and integrations across your workspace using keywords, filters, and operators.

Search is one of the fastest ways to navigate a growing workspace. Rather than clicking through menus and project lists, you can type a few characters and jump directly to any project, record, user, or integration in your account. Google indexes all workspace content in real time, so every item is findable the moment it's created or updated. Whether you're doing a quick keyword lookup or building a precise query with operators, search keeps everything within reach no matter how large your workspace grows.

## Basic Search

To open the global search bar from anywhere in the platform, press **`Cmd+K`** on macOS or **`Ctrl+K`** on Windows and Linux. You can also click the search icon in the top navigation bar.

Start typing to see results appear instantly. Google searches across all of the following content types by default:

* **Projects** — project names, descriptions, and tags
* **Records** — record titles, field values, and attached notes
* **Users** — names and email addresses of workspace members
* **Integrations** — connected app names and configuration labels
* **Activity** — recent events and audit log entries

Results are ranked by relevance and recency, with the most recently modified items weighted higher when query terms match equally across multiple results. Use the arrow keys to navigate the results list and press **Enter** to open the highlighted item.

<Tip>
  Wrap your search terms in double quotes to search for an exact phrase. For example, `"Q3 marketing"` will only return results that contain that exact string, filtering out results that contain the words separately. This is especially useful when searching for project names or record titles that include common words.
</Tip>

## Search Filters

After performing a search, you can refine your results using the filter panel on the left side of the results page. Filters are also available directly in the search bar using the syntax described in the [Advanced Search Syntax](#advanced-search-syntax) section below.

<Tabs>
  <Tab title="By Type">
    Filter results to a specific content type to narrow a broad query quickly.

    | Filter Value       | Returns                     |
    | ------------------ | --------------------------- |
    | `type:project`     | Only project records        |
    | `type:record`      | Only data records           |
    | `type:user`        | Only workspace members      |
    | `type:integration` | Only connected integrations |
    | `type:event`       | Only activity log entries   |

    **Example:** Find all projects whose name includes "onboarding":

    ```
    onboarding type:project
    ```

    **Example:** Find all user accounts matching "sarah":

    ```
    sarah type:user
    ```
  </Tab>

  <Tab title="By Date">
    Restrict results to items created or last modified within a specific time window.

    | Filter Value                  | Returns                                      |
    | ----------------------------- | -------------------------------------------- |
    | `date:today`                  | Items modified today                         |
    | `date:this-week`              | Items modified in the last 7 days            |
    | `date:this-month`             | Items modified in the current calendar month |
    | `date:2024-06-01..2024-06-30` | Items modified within a custom date range    |
    | `date:>2024-01-01`            | Items modified after a specific date         |

    **Example:** Find projects updated this week:

    ```
    type:project date:this-week
    ```

    **Example:** Find records modified in June 2024:

    ```
    type:record date:2024-06-01..2024-06-30
    ```
  </Tab>

  <Tab title="By Status">
    Filter results by the current status of the item. Available statuses depend on how your workspace has been configured.

    | Filter Value      | Returns                                     |
    | ----------------- | ------------------------------------------- |
    | `status:active`   | Items currently marked as active            |
    | `status:archived` | Archived projects or records                |
    | `status:draft`    | Items saved as drafts                       |
    | `status:complete` | Completed projects or tasks                 |
    | `status:error`    | Integrations or automation runs with errors |

    **Example:** Find all archived projects:

    ```
    type:project status:archived
    ```

    **Example:** Find integrations currently in an error state:

    ```
    type:integration status:error
    ```
  </Tab>
</Tabs>

## Advanced Search Syntax

Google supports a set of search operators that let you build highly specific queries directly in the search bar. Operators can be combined freely — just separate them with spaces.

| Operator  | Description                                                                                            | Example                       |
| --------- | ------------------------------------------------------------------------------------------------------ | ----------------------------- |
| `type:`   | Filter by content type (project, record, user, integration, event)                                     | `type:project`                |
| `date:`   | Filter by creation or modification date; supports values like `today`, `this-week`, or ISO date ranges | `date:2024-01-01..2024-03-31` |
| `status:` | Filter by item status                                                                                  | `status:active`               |
| `owner:`  | Filter by the user who created or owns the item; accepts name or email                                 | `owner:jane@example.com`      |
| `tag:`    | Filter by a tag applied to the item                                                                    | `tag:urgent`                  |
| `"..."`   | Exact phrase match — wrapping terms in quotes requires them to appear together                         | `"launch checklist"`          |
| `-`       | Exclude a term from results by prefixing it with a minus sign                                          | `onboarding -archived`        |

**Example — combining multiple operators:**

```
type:record owner:marcus@example.com tag:review status:active date:this-month
```

This query returns all active records owned by Marcus, tagged with "review", and modified during the current month.

## Saved Searches

If you frequently run the same search query, you can save it for one-click access from the search bar or the sidebar.

1. Run your search with any combination of keywords, operators, and filters.
2. Click **Save Search** in the top-right corner of the results page.
3. Give the saved search a name and optionally add it to the sidebar under **Quick Links**.
4. Click **Save**. Your saved search now appears under **Saved Searches** in the search bar dropdown.

To edit or delete a saved search, go to **Settings > Saved Searches**, find the entry you want to modify, and click **Edit** or **Delete**.

## Search via API

You can query workspace content programmatically using the Google REST API and integrate results into your own applications. The API exposes dedicated endpoints for each content type, all of which accept filter and pagination parameters to help you locate exactly what you need.

### Querying Users

Use `GET /users` to retrieve and filter workspace members:

```bash theme={null}
curl -X GET "https://api.google.com/v1/users?q=sarah&status=active&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Querying Data Records

Use `GET /data` to retrieve and filter data records across your workspace:

```bash theme={null}
curl -X GET "https://api.google.com/v1/data?q=onboarding&status=active&owner=jane%40example.com&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Querying Integrations

Use `GET /integrations` to list and filter connected integrations:

```bash theme={null}
curl -X GET "https://api.google.com/v1/integrations?status=active&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Common Query Parameters

All list endpoints share the following query parameters for filtering and pagination:

| Parameter   | Type    | Description                                                                             |
| ----------- | ------- | --------------------------------------------------------------------------------------- |
| `q`         | string  | Keyword search string, URL-encoded. Matched against names and relevant text fields.     |
| `status`    | string  | Filter by item status (e.g. `active`, `archived`, `error`). Optional.                   |
| `owner`     | string  | Filter by the owner's email address or user ID. Optional.                               |
| `date_from` | string  | ISO 8601 date — return only items created or modified on or after this date. Optional.  |
| `date_to`   | string  | ISO 8601 date — return only items created or modified on or before this date. Optional. |
| `limit`     | integer | Maximum number of results to return (default: `20`, max: `100`).                        |
| `offset`    | integer | Pagination offset for retrieving subsequent result pages.                               |

Each response returns a JSON object containing a `results` array and a `total` count. Every result includes the item's `id`, `type`, `name`, and relevant metadata fields. See the [API Reference](/api/introduction) for full response schemas, authentication details, and per-endpoint documentation.
