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

# compare_shops

> Compare 2 to 5 Shopify stores side by side: revenue, traffic, ads, catalog, markets, niches, and best products.

Returns 2 to 5 stores side by side, each with the same fields as a [`search_shops`](https://docs.copyfy.io/tools/search-shops) result, so you can benchmark competitors in one call. Use [`get_shop`](https://docs.copyfy.io/tools/get-shop) for one store's best ads, or for the traffic history of a store you track.

**Cost:** 1 credit per successful call, whatever the number of stores.

## Arguments

| Argument | Type | Allowed values |
| - | - | - |
| `shops` | array of objects | 2 to 5 stores. Each entry is `{ "shop_id": ... }`, a Copyfy store id from a search result (`id` or `shop.id`), or `{ "domain": ... }`, a store domain such as `example-store.com`. Required. |

Pass `shop_id` or `domain` in each entry, not both: an entry with both, or with neither, returns [`invalid_arguments`](https://docs.copyfy.io/errors#invalid_arguments). Entries that point to the same store, such as its id and its domain, count once.

## Example

```json Tool call theme={null}
{
  "name": "compare_shops",
  "arguments": {
    "shops": [
      { "domain": "example-pet-store.com" },
      { "shop_id": 913377 },
      { "domain": "unknown-example-store.com" }
    ]
  }
}
```

```json Result (trimmed) theme={null}
{
  "shops": [
    {
      "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"
        }
      ],
      "is_tracked": false
    },
    {
      "id": 913377,
      "name": "Example Paws",
      "domain": "example-paws.de",
      "dashboard_url": "https://app.copyfy.io/dashboard/track/913377",
      "country": "DE",
      "currency": "EUR",
      "niches": ["Pets"],
      "estimated_monthly_revenue": 96500,
      "monthly_visits": 71000,
      "traffic_growth_pct": -4.2,
      "active_ads": 12,
      "total_ads": 88,
      "products_count": 130,
      "top_markets": [{ "country": "DE", "share": 74 }],
      "best_products": [],
      "is_tracked": true
    }
  ],
  "not_found": [{ "domain": "unknown-example-store.com" }],
  "notice": "These stores use different currencies. Revenue and prices are in each store's currency (see currency): convert them before comparing."
}
```

## Result fields

| Field | Type | Description |
| - | - | - |
| `shops` | array | The stores, in the order of the arguments, with the [`search_shops` result fields](https://docs.copyfy.io/tools/search-shops#result-fields): up to 3 best products each, and `is_tracked`. |
| `not_found` | array | The entries Copyfy does not know, as you passed them. |
| `notice` | string | Present when the stores use different currencies. |

Revenue and prices are in each store's currency. As with `get_shop`, a store that is not in Copyfy's Top Shops index and that you do not track can have `null` revenue and traffic and no best products. Traffic history and ad breakdowns are not included: call [`get_shop`](https://docs.copyfy.io/tools/get-shop) on a store you track for them.

If fewer than 2 different stores are known, the call returns [`invalid_arguments`](https://docs.copyfy.io/errors#invalid_arguments) with the `not_found` entries, and no credit is used.


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