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

> Get the products Marcuus picked for the Copyfy Marcuus challenge, with costs, margins, and links.

Returns the products Marcuus selected for the Marcuus challenge, as the **Marcuus** page of the dashboard shows them: the weekly lists, newest week first, then the bonus picks. For each product you get its selling price, supplier cost, estimated margin, 30-day revenue, competition level and a competitor on the French market, its store, supplier and creative links, best ads, and a link that opens Store AI with the product pre-filled.

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

## Arguments

| Argument | Type | Allowed values |
| - | - | - |
| `week` | integer or `"bonus"` | `1` to `4` for one weekly list, `"bonus"` for the bonus picks. Omit it for every released pick. |
| `page` | integer | Page number, 1 to 20. Default: `1`. |
| `per_page` | integer | Picks per page, 1 to 10. Default: `10`. |

Each weekly list unlocks on its release date and the bonus picks when the challenge ends, as on the page. `next_release_at` tells when the next list unlocks.

## Example

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

```json Result (trimmed) theme={null}
{
  "current_week": 3,
  "challenge_ends_at": "2026-11-01T23:00:00.000Z",
  "next_release_at": "2026-10-25T23:00:00.000Z",
  "dashboard_url": "https://app.example.com/dashboard/products-list-q4",
  "results": [
    {
      "id": "214",
      "week": 3,
      "name": "Self-Cleaning Slicker Brush",
      "image_url": "https://bucket.app.example.com/marcuus-media/3f2a9c41d07b5e6f8a1c2d3e4f5a6b7c.webp",
      "product_url": "https://example-pet-store.com/products/self-cleaning-slicker-brush",
      "price": 29.9,
      "supplier_cost": 4.6,
      "currency": "EUR",
      "gross_margin_pct": 61.2,
      "revenue_30d_usd": 125000,
      "competition_level": "low",
      "shop": {
        "id": 902114,
        "name": "Example Pet Store",
        "domain": "example-pet-store.com",
        "dashboard_url": "https://app.example.com/dashboard/track/902114"
      },
      "supplier_url": "https://www.aliexpress.com/item/1005001234567890.html",
      "competitor_url": "https://example-competitor.com/products/pet-brush",
      "creative_url": "https://www.tiktok.com/@examplepets/video/7412345678901234567",
      "best_ads": [
        { "id": 5521907, "media_type": "video", "image_url": "https://bucket.app.example.com/ads/example-brush-preview.jpg" }
      ],
      "generate_store_url": "https://app.example.com/dashboard/store-ai?product=https%3A%2F%2Fexample-pet-store.com%2Fproducts%2Fself-cleaning-slicker-brush"
    }
  ],
  "pagination": { "page": 1, "per_page": 1, "total": 10, "has_more": true }
}
```

## Result fields

| Field | Type | Description |
| - | - | - |
| `current_week` | integer or null | The latest released week, 1 to 4. `null` before the challenge starts. |
| `challenge_ends_at` | string or null | When the challenge ends (ISO 8601). |
| `next_release_at` | string or null | When the next list unlocks (ISO 8601). `null` once everything is released. |
| `dashboard_url` | string | The Marcuus page in Copyfy. |
| `results` | array | The picks, described below. |
| `pagination` | object | `page`, `per_page`, `total`, `has_more`. |

Each pick:

| Field | Type | Description |
| - | - | - |
| `id` | string | Pick id. |
| `week` | integer or null | Weekly list of the pick. `null` for a bonus pick. |
| `name` | string or null | Product name. |
| `image_url` | string or null | Product image. |
| `product_url` | string | Product page, or the store when the pick has no product page. |
| `price` | number or null | Selling price, in `currency`. |
| `supplier_cost` | number or null | Supplier cost, in `currency`. |
| `currency` | string | Currency of `price` and `supplier_cost`. |
| `gross_margin_pct` | number or null | Estimated margin, in percent. |
| `revenue_30d_usd` | number or null | The page's 30-day revenue, in USD. |
| `competition_level` | string or null | Competition on the French market: `very_low`, `low`, `medium`, `high`, or `very_high`. |
| `shop` | object | The store selling it: `{ id, name, domain, dashboard_url }`. `id` and `dashboard_url` are `null` when Copyfy has no record of the store. Pass `id` to [`get_shop`](https://docs.copyfy.io/tools/get-shop). |
| `supplier_url` | string or null | Supplier listing, for example on AliExpress. |
| `competitor_url` | string or null | A competitor selling the product on the French market. |
| `creative_url` | string or null | A winning creative for the product, for example a TikTok video. |
| `best_ads` | array | Up to 3 best ads of the store: `{ id, media_type, image_url }`. |
| `generate_store_url` | string or null | Opens Copyfy Store AI with the product link pre-filled. Nothing is generated until you start it there. `null` when no importable product link is available. |

While the picks are not published, the tool returns [`feature_unavailable`](https://docs.copyfy.io/errors#feature_unavailable). Accounts connected through the Copyfy Shopify app get `feature_unavailable` too, as the Marcuus page is not available to them.


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