get_shop

Returns one store with the same fields as a 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, 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

Tool call

{
  "name": "get_shop",
  "arguments": { "domain": "example-pet-store.com" }
}

Result for a store you do not track (trimmed)

{
  "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, 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` 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.

Get started

Connect a client

Account

Tools reference

Guides

Help

Arguments

Example

Result fields

Full analytics require tracking

​Arguments

​Example

​Result fields

​Full analytics require tracking

Arguments

Example

Result fields

Full analytics require tracking