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

> Get one Shopify store by Copyfy id or domain, with its key metrics, best products, and best ads.

Returns one store with the same fields as a [`search_shops`](/tools/search-shops) result, plus its best products and best ads. For stores you track in Copyfy, it also returns traffic history and an ad breakdown. Use it to analyze a competitor.

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

## Arguments

Pass `shop_id` or `domain`, not both: a call with both returns [`invalid_arguments`](/errors#invalid_arguments), so an id and a domain from different stores never resolve silently to one of them.

| Argument  | Type                      | Allowed values                                                                                  |
| --------- | ------------------------- | ----------------------------------------------------------------------------------------------- |
| `shop_id` | integer or numeric string | Copyfy store id, from a search result (`id` or `shop.id`).                                      |
| `domain`  | string                    | Store domain, for example `example-store.com`. Copyfy matches it the same way as the dashboard. |

## Example

```json Tool call theme={null}
{
  "name": "get_shop",
  "arguments": { "domain": "example-pet-store.com" }
}
```

```json Result for a store you do not track (trimmed) theme={null}
{
  "id": 902114,
  "name": "Example Pet Store",
  "domain": "example-pet-store.com",
  "dashboard_url": "https://app.copyfy.io/dashboard/track/902114",
  "country": "US",
  "currency": "USD",
  "niches": ["Pets"],
  "estimated_monthly_revenue": 214800,
  "monthly_visits": 184000,
  "traffic_growth_pct": 18.4,
  "active_ads": 37,
  "total_ads": 305,
  "products_count": 42,
  "top_markets": [{ "country": "US", "share": 88 }],
  "best_products": [
    {
      "id": 48213377,
      "title": "Self-Cleaning Slicker Brush",
      "price": 24.99,
      "currency": "USD",
      "url": "https://example-pet-store.com/products/self-cleaning-slicker-brush"
    }
  ],
  "best_ads": [
    { "id": 5521907, "media_type": "video", "image_url": "https://bucket.copyfy.io/ads/example-brush-preview.jpg" }
  ],
  "is_tracked": false,
  "tracking_required_for_full_analytics": true
}
```

## Result fields

The result has the [`search_shops` result fields](/tools/search-shops#result-fields), with up to 5 best products instead of 3, plus:

| Field                                  | Type    | Description                                                                                                                                      |
| -------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `best_ads`                             | array   | Up to 5 best ads: `{ id, media_type, image_url }`. Use [`search_ads`](/tools/search-ads) with `query` set to the store name for full ad details. |
| `is_tracked`                           | boolean | `true` when you track this store in Copyfy.                                                                                                      |
| `tracking_required_for_full_analytics` | boolean | Present and `true` when you do not track the store.                                                                                              |
| `analytics`                            | object  | Only for tracked stores. See below.                                                                                                              |

`analytics` contains:

| Field                | Description                                                                                                                                                                       |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `traffic_history`    | Monthly `{ month, visits, estimated_revenue }` entries.                                                                                                                           |
| `active_ads_history` | Daily `{ date, active_ads }` entries.                                                                                                                                             |
| `ads_breakdown`      | `total_ads`, `active_ads`, and active ads by format: `active_video_ads`, `active_image_ads`, `active_carousel_ads`, `active_dco_ads`, `active_dpa_ads`, `active_partnership_ads`. |

## Full analytics require tracking

Traffic history and the ad breakdown are included only for stores you track in Copyfy, exactly like the store preview in the dashboard. For other stores, the result sets `tracking_required_for_full_analytics: true` and includes the `dashboard_url` where you can track the store. The MCP never uses your tracking slots on its own.

For a store that is not in Copyfy's Top Shops index and that you do not track, revenue and traffic can be `null`.

An unknown id or domain returns [`not_found`](/errors#not_found).