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

# get_tracking_feed

> What changed in the stores you track: Meta ads started or stopped, products added or removed, price changes, and product updates.

Returns what changed recently in the stores you track in Copyfy, newest first: Meta ads that started or stopped running, products added or removed, price changes, and product updates. It combines the **New ads** and **Updates** tabs of **Shop Analysis** in the dashboard, for every tracked store or for one of them. Use it for questions such as "What is new at my competitors this week?".

Reading the feed marks nothing as seen: the **New ads** counter in the dashboard does not change.

**Cost:** 1 credit per successful call.

## Arguments

Every argument is optional.

| Argument | Type | Allowed values |
| - | - | - |
| `shop_id` | integer or numeric string | Copyfy id of one store you track, from [`list_tracked_shops`](https://docs.copyfy.io/tools/list-tracked-shops). |
| `domain` | string | Domain of one store you track, for example `example-store.com`. |
| `since` | string | First day of the feed, `YYYY-MM-DD` in UTC, from 30 days ago to today. Default: 7 days ago. |
| `event_types` | array of enums | `new_ad`, `ad_stopped`, `product_added`, `product_removed`, `price_changed`, `product_updated`. Default: all of them. |
| `page` | integer | 1 to 20. Default: `1`. |
| `per_page` | integer | 1 to 25. Default: `20`. |

Without `shop_id` and `domain`, the feed covers every store you track. Pass one of them, not both: a call with both, or a `since` date outside the last 30 days, returns [`invalid_arguments`](https://docs.copyfy.io/errors#invalid_arguments). A store you do not track returns [`shop_not_tracked`](https://docs.copyfy.io/errors#shop_not_tracked), and so does a call while you track no store yet. None of these errors costs a credit.

## Event types

| Type | What happened | `date` |
| - | - | - |
| `new_ad` | A Meta ad started running. | The ad's start date in the Meta Ad Library. |
| `ad_stopped` | A Meta ad stopped running. | The last day Copyfy saw the ad running. |
| `product_added` | A product appeared in the store's catalog. | When Copyfy detected it. |
| `product_removed` | A product left the catalog. | When Copyfy detected it. |
| `price_changed` | The price of a product variant changed. | When Copyfy detected it. |
| `product_updated` | A product's title, vendor, or product type changed. | When Copyfy detected it. |

Changes appear once Copyfy has checked the store again. A new ad keeps its start date even when Copyfy finds it a few days later, so a narrow `since` window can come back empty: widen it, up to 30 days back.

## Example

The changes of the last week, three events per page:

```json Tool call theme={null}
{
  "name": "get_tracking_feed",
  "arguments": { "per_page": 3 }
}
```

```json Result (trimmed) theme={null}
{
  "since": "2026-10-19",
  "shop": null,
  "shops_covered": 12,
  "counts_by_type": {
    "new_ad": 9,
    "ad_stopped": 4,
    "product_added": 3,
    "product_removed": 1,
    "price_changed": 14,
    "product_updated": 2
  },
  "results": [
    {
      "type": "new_ad",
      "date": "2026-10-25T00:00:00.000Z",
      "description": "New video ad started running.",
      "shop": { "id": 845120, "name": "Example Paws", "domain": "example-paws.com" },
      "ad": {
        "id": 5521907,
        "ad_archive_id": "1187340029915522",
        "media_type": "video",
        "headline": "Back in stock",
        "ad_text": "Our best-selling harness is back. Free shipping this week only.",
        "image_url": "https://bucket.copyfy.io/media/1187340029915522/poster.jpg",
        "ad_library_url": "https://www.facebook.com/ads/library/?id=1187340029915522",
        "started_at": "2026-10-25T00:00:00.000Z",
        "ended_at": null,
        "is_active": true
      },
      "dashboard_url": "https://app.copyfy.io/dashboard/track/845120"
    },
    {
      "type": "price_changed",
      "date": "2026-10-24T06:12:31.000Z",
      "description": "Price lowered from 39.9 to 29.9 USD.",
      "shop": { "id": 902114, "name": "Example Pet Store", "domain": "example-pet-store.com" },
      "product": {
        "id": 48213377,
        "title": "Self-Cleaning Slicker Brush",
        "url": "https://example-pet-store.com/products/self-cleaning-slicker-brush",
        "image_url": "https://cdn.shopify.com/s/files/1/example/brush.jpg",
        "currency": "USD",
        "price": 29.9,
        "old_price": 39.9,
        "variant_title": "Large"
      },
      "dashboard_url": "https://app.copyfy.io/dashboard/track/902114"
    },
    {
      "type": "product_added",
      "date": "2026-10-23T18:40:02.000Z",
      "description": "New product added at 24.99 USD.",
      "shop": { "id": 902114, "name": "Example Pet Store", "domain": "example-pet-store.com" },
      "product": {
        "id": 48213590,
        "title": "Lick Mat for Dogs",
        "url": "https://example-pet-store.com/products/lick-mat",
        "image_url": "https://cdn.shopify.com/s/files/1/example/lick-mat.jpg",
        "currency": "USD",
        "price": 24.99
      },
      "dashboard_url": "https://app.copyfy.io/dashboard/track/902114"
    }
  ],
  "pagination": { "page": 1, "per_page": 3, "total": 33, "has_more": true },
  "dashboard_url": "https://app.copyfy.io/dashboard/analyze-shop"
}
```

## Result fields

| Field | Type | Description |
| - | - | - |
| `since` | string | First day of the feed (`YYYY-MM-DD`, UTC). The feed runs from that day until now. |
| `shop` | object or null | The store you passed with `shop_id` or `domain`: `id`, `name`, `domain`, `dashboard_url`. `null` when the feed covers every tracked store. |
| `shops_covered` | integer | Number of stores the feed reads. |
| `counts_by_type` | object | Events of each requested type in the whole window, across all pages. |
| `results` | array | Events, newest first. See below. |
| `pagination` | object | `page`, `per_page`, `total` (all events in the window), and `has_more`. |
| `dashboard_url` | string | The **Shop Analysis** page, with its **New ads** and **Updates** tabs. |

Each event has:

| Field | Type | Description |
| - | - | - |
| `type` | string | One of the event types above. |
| `date` | string | When it happened (ISO 8601), as described above. |
| `description` | string | A one-line summary written by Copyfy. It contains no store name, product title, or ad copy. |
| `shop` | object | `id`, `name`, and `domain` of the store. |
| `ad` | object | For `new_ad` and `ad_stopped`: `id` (Copyfy ad id), `ad_archive_id`, `media_type`, `headline` (up to 150 characters), `ad_text` (up to 280 characters), `image_url`, `ad_library_url`, `started_at`, `ended_at`, and `is_active`. A field Copyfy no longer has is `null`. |
| `product` | object | For product events: `id` (Copyfy product id, `null` once the product is removed), `title` (up to 150 characters), `url`, `image_url`, `currency`, and `price`. `price_changed` adds `old_price` and `variant_title`, and `price` is then the new price. `product_updated` adds `changed_fields`, for example `["title", "product_type"]`. |
| `dashboard_url` | string | The store's page in Copyfy. |

Pass a product `id` to [`get_product`](https://docs.copyfy.io/tools/get-product). Store names, product titles, and ad copy are third-party content.

## Narrow a busy feed

Prices change per variant, so a store running a sale can fill several pages with `price_changed` events. Read `counts_by_type`, then narrow with `event_types` (for example `["new_ad"]`), `shop_id`, or a later `since`. Pages stop at 20, so at most 500 events of a window are reachable with 25 events per page. If a page exceeds 64 KiB, the call returns [`result_too_large`](https://docs.copyfy.io/errors#result_too_large) without charging a credit: request fewer events per page.


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