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

# run_saved_search

> Run one of your saved Copyfy searches and get its current results.

Runs a search you saved on the **Shops**, **Products**, or **Ads** page of the dashboard, with its saved filters and ranking, and returns its current results. The results have the same fields as [`search_shops`](https://docs.copyfy.io/tools/search-shops), [`search_products`](https://docs.copyfy.io/tools/search-products), or [`search_ads`](https://docs.copyfy.io/tools/search-ads), depending on where you saved the search. Get the ids with [`list_saved_items`](https://docs.copyfy.io/tools/list-saved-items).

**Cost:** 1 credit per successful call that returns results. A run with no results is free, and `credits_used` in the response states what the call cost.

## Arguments

| Argument | Type | Allowed values |
| - | - | - |
| `saved_search_id` | integer or numeric string | Id of one of your saved searches, from `list_saved_items` with `type: "searches"`. |
| `page` | integer | Page number, 1 to 20. Default: `1`. |
| `per_page` | integer | Results per page, 1 to 25. Default: `10`. |

## Example

```json Tool call theme={null}
{
  "name": "run_saved_search",
  "arguments": { "saved_search_id": 4318, "per_page": 5 }
}
```

```json Result (trimmed) theme={null}
{
  "saved_search": {
    "id": 4318,
    "name": "Scaling pet stores",
    "kind": "shops",
    "summary": "niches: Pets; countries: US; active ads at least 30; sorted by traffic_growth",
    "dashboard_url": "https://app.copyfy.io/dashboard/shops?countries=US&niches=Pets&minAds=30&sort=growth_rate"
  },
  "results": [
    {
      "id": 902114,
      "name": "Example Pet Store",
      "domain": "example-pet-store.com",
      "dashboard_url": "https://app.copyfy.io/dashboard/track/902114",
      "country": "US",
      "currency": "USD",
      "niches": ["Pets"],
      "estimated_monthly_revenue": 214800,
      "monthly_visits": 184000,
      "traffic_growth_pct": 18.4,
      "active_ads": 37,
      "is_tracked": false
    }
  ],
  "pagination": { "page": 1, "per_page": 5, "total": 64, "has_more": true },
  "credits_used": 1
}
```

## Result fields

`saved_search` describes the search that ran:

| Field | Type | Description |
| - | - | - |
| `id` | integer | Saved search id. |
| `name` | string | The name you gave the search. |
| `kind` | string | `shops`, `products`, or `ads`. |
| `summary` | string | The saved filters and sort in plain words. |
| `dashboard_url` | string | Opens the matching dashboard page with the saved filters, as in [`list_saved_items`](https://docs.copyfy.io/tools/list-saved-items#result-fields). |

`results`, `pagination`, and any `notice` follow the result fields of [`search_shops`](https://docs.copyfy.io/tools/search-shops#result-fields), [`search_products`](https://docs.copyfy.io/tools/search-products), or [`search_ads`](https://docs.copyfy.io/tools/search-ads), according to `kind`.

The search runs as it does when you select it in the dashboard. Saved niches that Copyfy no longer lists are ignored, as in the dashboard. A saved search of another account, or an id that does not exist, returns [`not_found`](https://docs.copyfy.io/errors#not_found).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.