# Use saved searches

Return to Search Results you already created and understand what changes when you filter them.

Canonical URL: https://help.mjhr.ai/saved-searches
Machine-readable page: https://help.mjhr.ai/saved-searches/README.md
Full help context: https://help.mjhr.ai/llms-full.txt
Audience: Users

## What a saved search keeps

A Saved Search keeps the prompt, filters, and companies returned when the search was created. Reopening it returns to that saved result set.

If you start without an account, Mjhr keeps that history in the same browser until you create an account and claim it. In a workspace, saved searches belong to that workspace so teammates can return to shared research.

## When to use a saved search

- You found useful Search Results and want to continue from them later.
- You want to compare the same result set after changing filters or sorting.
- You need a stable result set for review, outreach planning, or an integration.
- You want teammates to see the original search context, not just copied company names.

## Work with a saved search

- Run a search: Describe the companies you want and add filters such as location, category, or company type.
- Open it from history: Use the saved searches list or search history settings to return to the same saved search.
- Narrow the list: Filtering or sorting a result page helps you inspect the saved companies. It does not expand the search into new companies.
- Keep history clean: Rename searches when the original prompt is not clear, move them into folders, and archive searches you no longer need.

## Important boundaries

- A saved result page shows the companies captured when the search was created.
- Filters on a result page narrow the saved set; they do not run a new broader search.
- Use the public search ID shown by the product or API. Internal database IDs are not part of the public contract.

Note: If a list feels incomplete, create a new search with a broader prompt or fewer filters instead of expecting an old saved search to grow automatically.

## For integrations

An integration can list saved searches, fetch one search by public ID, then read the companies and branches stored under that search.

### List saved searches

```bash
curl -H "Authorization: Bearer $MJHR_API_KEY" \
  "$MJHR_API_ORIGIN/v1/searches?limit=25"
```

### List results for one search

```bash
curl -H "Authorization: Bearer $MJHR_API_KEY" \
  "$MJHR_API_ORIGIN/v1/searches/$SEARCH_ID/results?limit=100"
```