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

> List the Shopify stores you track in Copyfy, with their key metrics and the tracking slots left on your plan.

Returns the stores you track in Copyfy, the same list as **Tracked Shops** on the **Shop Analysis** page of the dashboard. Each store comes with its estimated monthly revenue, monthly visits, traffic growth, and active Meta ads, and the result shows how many tracking slots your plan has left. Use the store ids with [`get_shop`](https://docs.copyfy.io/tools/get-shop) or [`get_tracking_feed`](https://docs.copyfy.io/tools/get-tracking-feed).

**Cost:** free.

## Arguments

Every argument is optional.

| Argument | Type | Allowed values |
| - | - | - |
| `sort_by` | enum | `tracked_at` (when you started tracking the store), `revenue`, `traffic`, `traffic_growth`, `active_ads`. Default: `tracked_at`. |
| `sort_order` | enum | `asc`, `desc`. Default: `desc`, so the most recently tracked stores or the highest values come first. |
| `page` | integer | 1 to 100. Default: `1`. |
| `per_page` | integer | 1 to 50. Default: `25`. |

Stores without the metric you rank by come last in both directions.

## Example

Your tracked stores with the highest revenue first:

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

```json Result (trimmed) theme={null}
{
  "results": [
    {
      "id": 902114,
      "name": "Example Pet Store",
      "domain": "example-pet-store.com",
      "dashboard_url": "https://app.copyfy.io/dashboard/track/902114",
      "tracked_at": "2026-10-02T09:14:00.000Z",
      "country": "US",
      "currency": "USD",
      "estimated_monthly_revenue": 214800,
      "monthly_visits": 184000,
      "traffic_growth_pct": 18,
      "active_ads": 37
    },
    {
      "id": 845120,
      "name": "Example Paws",
      "domain": "example-paws.com",
      "dashboard_url": "https://app.copyfy.io/dashboard/track/845120",
      "tracked_at": "2026-09-21T16:40:00.000Z",
      "country": "US",
      "currency": "USD",
      "estimated_monthly_revenue": 96500,
      "monthly_visits": 71000,
      "traffic_growth_pct": -4,
      "active_ads": 58
    }
  ],
  "pagination": { "page": 1, "per_page": 2, "total": 12, "has_more": true },
  "tracking_slots": { "used": 12, "limit": 25, "remaining": 13 },
  "dashboard_url": "https://app.copyfy.io/dashboard/analyze-shop"
}
```

## Result fields

| Field | Type | Description |
| - | - | - |
| `results` | array | The tracked stores of the page. See below. |
| `pagination` | object | `page`, `per_page`, `total` (tracked stores Copyfy can list), and `has_more`. |
| `tracking_slots` | object or null | `used`: slots in use. `limit`: slots on your plan, or your account's higher custom limit when it has one. `remaining`: stores you can still track. `null` when Copyfy cannot read your plan's limit; the list still loads. |
| `dashboard_url` | string | The **Shop Analysis** page, where you track and untrack stores. |

Each store has:

| Field | Type | Description |
| - | - | - |
| `id` | integer | Copyfy store id. Pass it to [`get_shop`](https://docs.copyfy.io/tools/get-shop) or [`get_tracking_feed`](https://docs.copyfy.io/tools/get-tracking-feed). |
| `name` | string | Store name (third-party content). |
| `domain` | string or null | Store domain. |
| `dashboard_url` | string | The store's page in Copyfy. |
| `tracked_at` | string or null | When you started tracking the store (ISO 8601). `null` for some older entries. |
| `country` | string or null | Store country (ISO 3166-1 alpha-2). |
| `currency` | string or null | Store currency (ISO 4217). |
| `estimated_monthly_revenue` | number or null | Estimated monthly revenue, in the store's currency. |
| `monthly_visits` | number or null | Estimated monthly visits. |
| `traffic_growth_pct` | number or null | Traffic growth score, in percent, as in [`search_shops`](https://docs.copyfy.io/tools/search-shops#result-fields). It can differ from the growth badge in the dashboard, which is measured on the chart. |
| `active_ads` | integer | Currently active Meta ads. |

The metrics follow the same definitions as in [`get_shop`](https://docs.copyfy.io/tools/get-shop) and [`search_shops`](https://docs.copyfy.io/tools/search-shops).

## Tracking slots

`tracking_slots.used` counts every store you track, including a store that Copyfy no longer lists. Such a store still uses a slot but is left out of `results`, so `used` can be higher than `pagination.total`.

You track and untrack stores with [`track_shop`](https://docs.copyfy.io/tools/track-shop) and [`untrack_shop`](https://docs.copyfy.io/tools/untrack-shop), or from the dashboard. Tracking a store unlocks its analytics in [`get_shop`](https://docs.copyfy.io/tools/get-shop), its products in [`get_product`](https://docs.copyfy.io/tools/get-product), and its changes in [`get_tracking_feed`](https://docs.copyfy.io/tools/get-tracking-feed).


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