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

> What is new since yesterday in your niches and markets: new winning products, new Meta ads, and accelerating stores, in one call.

Returns what is new in your niches and markets since yesterday, in three short lists: winning products created since the start of the window, Meta ads that started in the window and are still running, and stores whose traffic is accelerating. It is built for a scheduled task in ChatGPT or Claude, such as "every morning, give me my Copyfy radar", and replaces three separate searches.

**Cost:** 1 credit per successful call, for all three lists.

## Arguments

Every argument is optional. Without `niches` and `countries`, the radar uses the niches and countries most common among the stores you track in Copyfy, and says so in `inferred_from`.

| Argument | Type | Allowed values |
| - | - | - |
| `niches` | array of strings or integers | Niche names or ids from [`list_filter_options`](https://docs.copyfy.io/tools/list-filter-options) with `kind: "niches"`. A parent niche includes its sub-niches. Up to 20. |
| `countries` | array of strings | Store countries as ISO 3166-1 alpha-2 codes, for example `US`, `FR`. Up to 50. |
| `since` | string | First day of the radar, `YYYY-MM-DD` in UTC, from 7 days ago to today. Default: yesterday. |
| `per_section` | integer | Items per list, 1 to 10. Default: `5`. |

An unknown niche, or a `since` date outside the last 7 days, returns [`invalid_arguments`](https://docs.copyfy.io/errors#invalid_arguments) without charging a credit.

## Example

A radar based on the stores you track, two items per list:

```json Tool call theme={null}
{
  "name": "get_daily_radar",
  "arguments": { "per_section": 2 }
}
```

```json Result (trimmed) theme={null}
{
  "window_start": "2026-10-25",
  "window_end": "2026-10-26",
  "inferred_from": {
    "source": "tracked_shops",
    "tracked_shops": 8,
    "niches": [{ "id": 12, "name": "Pets" }],
    "countries": ["US", "CA"],
    "message": "No niches or countries were passed, so the radar uses the most common niches and countries of the stores the user tracks in Copyfy. Pass niches or countries to choose others."
  },
  "new_products": {
    "items": [
      {
        "id": 48213377,
        "title": "Self-Cleaning Slicker Brush",
        "price": 24.99,
        "currency": "USD",
        "created_at": "2026-10-25T14:02:00.000Z",
        "url": "https://example-pet-store.com/products/self-cleaning-slicker-brush",
        "image_url": "https://cdn.shopify.com/s/files/1/example/brush.jpg",
        "shop": {
          "id": 902114,
          "name": "Example Pet Store",
          "domain": "example-pet-store.com",
          "country": "US",
          "estimated_monthly_revenue": 214800,
          "traffic_growth_pct": 18.4,
          "active_ads": 37,
          "is_tracked": false
        },
        "dashboard_url": "https://app.copyfy.io/dashboard/track/902114"
      }
    ],
    "has_more": false
  },
  "new_ads": {
    "items": [
      {
        "id": 5521907,
        "ad_archive_id": "1187340029915522",
        "page_name": "Example Paws",
        "media_type": "video",
        "headline": "Back in stock",
        "ad_text": "Our best-selling harness is back. Free shipping this week only.",
        "cta": "Shop Now",
        "landing_url": "https://example-paws.com/products/no-pull-harness",
        "image_url": "https://bucket.copyfy.io/media/1187340029915522/poster.jpg",
        "video_url": "https://bucket.copyfy.io/media/1187340029915522/clip.mp4",
        "ad_library_url": "https://www.facebook.com/ads/library/?id=1187340029915522",
        "started_at": "2026-10-25",
        "active_days": 1,
        "shop": { "id": 845120, "name": "Example Paws", "domain": "example-paws.com", "country": "US", "active_ads": 58 },
        "dashboard_url": "https://app.copyfy.io/dashboard/track/845120"
      }
    ],
    "total": 214,
    "has_more": true
  },
  "accelerating_shops": {
    "items": [
      {
        "id": 77310,
        "name": "Example Cat Co",
        "domain": "example-cat.co",
        "dashboard_url": "https://app.copyfy.io/dashboard/track/77310",
        "country": "CA",
        "currency": "CAD",
        "niches": ["Pets"],
        "estimated_monthly_revenue": 61200,
        "monthly_visits": 48000,
        "traffic_growth_pct": 142.5,
        "active_ads": 9,
        "is_tracked": false,
        "top_markets": [{ "country": "CA", "share": 71 }, { "country": "US", "share": 22 }],
        "best_product": {
          "id": 61003921,
          "title": "Window Cat Hammock",
          "price": 39,
          "currency": "CAD",
          "image_url": "https://cdn.shopify.com/s/files/1/example/hammock.jpg",
          "url": "https://example-cat.co/products/window-cat-hammock"
        }
      }
    ],
    "has_more": true
  }
}
```

## How each list is built

| List | Content |
| - | - |
| `new_products` | The newest products of Copyfy Top Products (the `newest` ranking of [`search_products`](https://docs.copyfy.io/tools/search-products)), kept when they were created on their store on or after `window_start`. |
| `new_ads` | Meta ads that started between `window_start` and `window_end` and are still running: one ad per store, stores with the most active ads first (the `recommended` ranking of [`search_ads`](https://docs.copyfy.io/tools/search-ads)). |
| `accelerating_shops` | The stores with the highest traffic growth among stores with at least 10,000 monthly visits, at least 10% traffic growth, and at least one active Meta ad (the `traffic_growth` ranking of [`search_shops`](https://docs.copyfy.io/tools/search-shops)). Traffic growth is measured monthly, so this list does not depend on `since`. |

Dates are in UTC. Products and ads appear once Copyfy has collected and indexed them, so a one-day window can return an empty list: widen `since`, up to 7 days back.

## Result fields

| Field | Type | Description |
| - | - | - |
| `window_start` | string | First day of the radar (`YYYY-MM-DD`, UTC). |
| `window_end` | string | Last day of the radar: today (`YYYY-MM-DD`, UTC). |
| `inferred_from` | object or null | `null` when you pass `niches` or `countries`. Otherwise it explains the scope: `source` is `tracked_shops`, or `none` when you track no store and the radar covers every niche and country; `tracked_shops` counts the stores you track; `niches` lists up to 5 `{ id, name }` parent niches (sub-niches roll up to their parent); `countries` lists up to 5 store countries; `message` explains the choice. |
| `new_products` | object | `items`: products with the fields of a [`search_products` result](https://docs.copyfy.io/tools/search-products#result-fields), a title cut to 150 characters, and a shorter `shop`. `has_more`: more new products match. |
| `new_ads` | object | `items`: ads with the fields of a [`search_ads` result](https://docs.copyfy.io/tools/search-ads#result-fields) except `status`, `last_seen_at`, and `is_partnership`, with `ad_text` cut to 280 characters. `total`: matching ads. `has_more`: more stores match. |
| `accelerating_shops` | object | `items`: stores with the main fields of a [`search_shops` result](https://docs.copyfy.io/tools/search-shops#result-fields), up to 3 `top_markets`, and one `best_product` instead of `best_products` (`null` when Copyfy has none). `has_more`: more stores match. |

Store names, product titles, and ad copy are third-party content.

## When a list is unavailable

If one search is temporarily unavailable, its list returns `items: []` and an `error` object with a `code` and a `message`, and the other lists still load. The call then costs 1 credit. If the lists that did load are empty, or all three searches fail, the call fails without charging a credit, with [`search_unavailable`](https://docs.copyfy.io/errors#search_unavailable) when the search engine is down.

If Copyfy cannot read the stores you track, the call returns [`service_unavailable`](https://docs.copyfy.io/errors#service_unavailable) without charging a credit. Retry, or pass `niches` or `countries`.

The radar stays under the 64 KiB result limit: when long links would push it over, the heaviest list drops its last items and sets `has_more` to `true`.

## Schedule it

In ChatGPT or Claude, create a scheduled task such as "Every morning at 8, call get\_daily\_radar and summarize the new products, new ads, and accelerating stores with their links." Each run costs 1 credit.


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