> ## 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.

# save_items

> Bookmark ads and save searches in your Copyfy account.

Saves items in your Copyfy account: it bookmarks Meta ads and saves searches. A saved search appears in the saved filters of the **Products**, **Shops**, or **Ads** page of the dashboard, and [`run_saved_search`](https://docs.copyfy.io/tools/run-saved-search) runs it again. [`list_saved_items`](https://docs.copyfy.io/tools/list-saved-items) lists everything you saved.

Copyfy tells your assistant to call it only when you ask, for example *"Save this search as US pet winners."*, and marks it as a tool that changes your account so your client can ask you first.

**Cost:** free.

## Arguments

| Argument | Type | Allowed values |
| - | - | - |
| `ad_ids` | array of ids | Up to 25 Copyfy ad ids to bookmark: the `id` of ads returned by [`search_ads`](https://docs.copyfy.io/tools/search-ads), [`get_shop`](https://docs.copyfy.io/tools/get-shop), or [`lookup`](https://docs.copyfy.io/tools/lookup). |
| `search` | object | A search to save, with the fields below. |

Pass `ad_ids`, `search`, or both.

| `search` field | Type | Allowed values |
| - | - | - |
| `kind` | enum | `products`, `shops`, or `ads`: the search tool the filters come from. |
| `name` | string | 1 to 100 characters, shown in the dashboard. |
| `filters` | object | The arguments of [`search_products`](https://docs.copyfy.io/tools/search-products), [`search_shops`](https://docs.copyfy.io/tools/search-shops), or [`search_ads`](https://docs.copyfy.io/tools/search-ads), for example `{ "niches": ["Pets"], "countries": ["US"] }`. `page` and `per_page` are ignored. Default: no filters. |

Saving something you already saved changes nothing: an ad you already bookmarked is listed under `already_saved`, and a search whose filters match one of your saved searches returns that saved search. Copyfy has no favorite products: save a products search instead. The **Ads** page has no Trustpilot filters, so an ads search with `trustpilot_rating` or `trustpilot_reviews` cannot be saved. A saved search keeps fixed dates, so a date range needs both `from` and `to`.

## Example

```json Tool call theme={null}
{
  "name": "save_items",
  "arguments": {
    "ad_ids": [5521907],
    "search": {
      "kind": "products",
      "name": "US pet winners",
      "filters": { "niches": ["Pets"], "countries": ["US"], "monthly_revenue": { "min": 20000 }, "sort_by": "revenue" }
    }
  }
}
```

```json Result theme={null}
{
  "ads": { "saved": [5521907], "already_saved": [], "not_found": [] },
  "search": {
    "status": "saved",
    "saved_search": {
      "id": 4312,
      "name": "US pet winners",
      "kind": "products",
      "summary": "niches: Pets; countries: US; monthly revenue at least 20000; sorted by revenue",
      "dashboard_url": "https://app.copyfy.io/dashboard/products?countries=US&niches=Pets&minRev=20000&sort=estimated_monthly"
    }
  }
}
```

## Result fields

The result has one key per part you passed: `ads` and `search`.

| Field | Type | Description |
| - | - | - |
| `ads.saved` | array | Ads bookmarked by this call. |
| `ads.already_saved` | array | Ads you had already bookmarked. |
| `ads.not_found` | array | Ids that match no Copyfy ad. |
| `search.status` | string | `saved`, or `already_saved` when one of your saved searches has the same filters. |
| `search.saved_search` | object | The saved search, described as in [`list_saved_items`](https://docs.copyfy.io/tools/list-saved-items): `id`, `name`, `kind`, `summary`, and `dashboard_url`. |

## Errors

[`invalid_arguments`](https://docs.copyfy.io/errors#invalid_arguments) when there is nothing to save, or when `filters` are not valid arguments of the search tool: an unknown argument, an unknown niche, a range whose `min` is above its `max`, a date range without `to`, or Trustpilot filters in an ads search. A refused call saves nothing, not even the ads. If the search cannot be written after the ads were bookmarked, the call returns [`service_unavailable`](https://docs.copyfy.io/errors#service_unavailable) with the bookmarked ads in `ads`: retry it, nothing is saved twice.


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