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

# list_saved_items

> List the ads you bookmarked and the searches you saved in Copyfy.

Returns what you saved in Copyfy: the ads you bookmarked and the searches you saved on the **Shops**, **Products**, and **Ads** pages of the dashboard. Use it to resume your own research, then run a saved search with [`run_saved_search`](https://docs.copyfy.io/tools/run-saved-search). Add and remove items with [`save_items`](https://docs.copyfy.io/tools/save-items) and [`remove_saved_item`](https://docs.copyfy.io/tools/remove-saved-item).

**Cost:** free.

## Arguments

| Argument | Type | Allowed values |
| - | - | - |
| `type` | enum | `all`, `ads` (bookmarked ads), `searches` (saved searches). Default: `all`. |
| `page` | integer | Page number, from 1. It applies to each returned list. Default: `1`. |
| `per_page` | integer | Items per list and page, 1 to 15. Default: `10`. |

Copyfy has no favorite products. To find products again, use [`search_products`](https://docs.copyfy.io/tools/search-products) or a saved products search.

## Example

```json Tool call theme={null}
{
  "name": "list_saved_items",
  "arguments": { "per_page": 2 }
}
```

```json Result (trimmed) theme={null}
{
  "ads": {
    "results": [
      {
        "id": 5521907,
        "ad_archive_id": "1187402235561903",
        "page_name": "Example Pet Store",
        "status": "active",
        "media_type": "video",
        "headline": "The brush that cleans itself",
        "ad_text": "One click and the fur is gone. Free shipping this week.",
        "image_url": "https://bucket.copyfy.io/ads/example-brush-preview.jpg",
        "ad_library_url": "https://www.facebook.com/ads/library/?id=1187402235561903",
        "shop": { "id": 902114, "name": "Example Pet Store", "domain": "example-pet-store.com" },
        "dashboard_url": "https://app.copyfy.io/dashboard/track/902114",
        "bookmarked_at": "2026-10-20T08:30:00.000Z"
      }
    ],
    "pagination": { "page": 1, "per_page": 2, "total": 1, "has_more": false }
  },
  "searches": {
    "results": [
      {
        "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",
        "created_at": "2026-10-01T10:00:00.000Z"
      }
    ],
    "pagination": { "page": 1, "per_page": 2, "total": 3, "has_more": true }
  }
}
```

## Result fields

The result has one key per requested list: `ads` and `searches`. Each list has `results` and `pagination` (`page`, `per_page`, `total`, `has_more`). Ads are listed from the most recently bookmarked, searches from the most recently saved.

Bookmarked ads:

| Field | Type | Description |
| - | - | - |
| `id` | integer | Copyfy ad id. |
| `ad_archive_id` | string or null | Meta Ad Library id. |
| `page_name` | string or null | Facebook page that runs the ad (third-party content). |
| `status` | string | `active` or `inactive`. |
| `media_type` | string or null | Ad format, for example `video` or `image`. |
| `headline` | string or null | Ad headline, up to 120 characters (third-party content). |
| `ad_text` | string or null | Ad copy, up to 240 characters (third-party content). |
| `image_url` | string or null | Ad thumbnail. |
| `ad_library_url` | string or null | The ad in the Meta Ad Library. |
| `shop` | object or null | The store behind the ad: `{ id, name, domain }`. Pass `id` to [`get_shop`](https://docs.copyfy.io/tools/get-shop). |
| `dashboard_url` | string or null | The store's page in Copyfy. |
| `bookmarked_at` | string | When you bookmarked the ad (ISO 8601). |

Saved searches:

| Field | Type | Description |
| - | - | - |
| `id` | integer | Saved search id. Pass it to [`run_saved_search`](https://docs.copyfy.io/tools/run-saved-search). |
| `name` | string | The name you gave the search. |
| `kind` | string | `shops`, `products`, or `ads`: the dashboard page where you saved it. |
| `summary` | string | The saved filters and sort in plain words. Sorts use the `sort_by` names of the search tools. |
| `dashboard_url` | string | Opens the matching dashboard page with the saved filters. |
| `created_at` | string or null | When you saved the search (ISO 8601). |

The `dashboard_url` of a saved search does not include its free-text search, which the page cannot read from a link. The page also lists your saved searches under its saved filters: selecting one there applies all of it. When the filters are too many for a link, `dashboard_url` opens the page itself.


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