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

# track_shop

> Track a store in your Copyfy account from your AI assistant.

Tracks a store in your Copyfy account, like the **Track** button of the dashboard. Tracking uses one of your plan's tracking slots and unlocks the store's analytics in [`get_shop`](https://docs.copyfy.io/tools/get-shop), its products in [`get_product`](https://docs.copyfy.io/tools/get-product), its marketing insights in [`get_shop_insights`](https://docs.copyfy.io/tools/get-shop-insights), its ad breakdowns in [`analyze_ad`](https://docs.copyfy.io/tools/analyze-ad), and its changes in [`get_tracking_feed`](https://docs.copyfy.io/tools/get-tracking-feed).

Copyfy tells your assistant to call it only when you ask, for example *"Track example-pet-store.com and show me its best products."*, and marks it as a tool that changes your account so your client can ask you first.

**Cost:** free.

## Arguments

| Argument | Type | Allowed values |
| - | - | - |
| `shop_id` | integer or numeric string | Copyfy store id, from a search result or [`lookup`](https://docs.copyfy.io/tools/lookup). |
| `domain` | string | The store's domain or URL, for example `example-pet-store.com`, including a store Copyfy does not know yet. |

Pass `shop_id` or `domain`, not both.

A store Copyfy does not know yet is checked first: Copyfy visits the site, confirms that it is a standalone online store selling physical products, and adds it. Each account can check up to 20 new stores a day. Some stores take longer to check than an AI app can wait: the result then says `status: "checking"`, and calling `track_shop` again a minute later gives the outcome. If it answers `checking` again, add the store from the dashboard link in the result. A new store's traffic, products, and ads load in the background: the result says `data_status: "loading"` and the store's data appears within a few minutes. Copyfy does not track marketplaces such as Amazon or Etsy, or a store's `myshopify.com` address.

## Example

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

```json Result theme={null}
{
  "status": "tracked",
  "shop": {
    "id": 902114,
    "name": "Example Pet Store",
    "domain": "example-pet-store.com",
    "dashboard_url": "https://app.copyfy.io/dashboard/track/902114"
  },
  "data_status": "ready",
  "message": "The store is now tracked: get_product, get_shop_insights, analyze_ad and get_tracking_feed work on it.",
  "tracking_slots": { "used": 4, "limit": 10, "remaining": 6 }
}
```

## Result fields

| Field | Type | Description |
| - | - | - |
| `status` | string | `tracked`; `already_tracked` when you already tracked the store, which changes nothing; or `checking` while Copyfy still checks a new store (`shop` is then `null`). |
| `shop` | object | The store: `{ id, name, domain, dashboard_url }`. |
| `data_status` | string | `ready`, or `loading` while Copyfy collects the store's data (`unknown` with `checking`). |
| `message` | string | What happened and which tools now work on the store. |
| `tracking_slots` | object or null | `{ used, limit, remaining }` after the call, or `null` when Copyfy could not read your plan's limit. |

## Errors

| Code | When |
| - | - |
| [`tracking_limit_reached`](https://docs.copyfy.io/errors#tracking_limit_reached) | All your tracking slots are used. Stop tracking a store with [`untrack_shop`](https://docs.copyfy.io/tools/untrack-shop), or upgrade. |
| [`shop_not_trackable`](https://docs.copyfy.io/errors#shop_not_trackable) | Copyfy cannot track this site. `reason` says why. |
| [`invalid_arguments`](https://docs.copyfy.io/errors#invalid_arguments) | The domain is not valid or is a `myshopify.com` address, or both `shop_id` and `domain` were passed. |
| [`rate_limited`](https://docs.copyfy.io/errors#rate_limited) | The account checked 20 new stores in the last 24 hours. Stores Copyfy already knows can still be tracked. |
| [`not_found`](https://docs.copyfy.io/errors#not_found) | No Copyfy store has this `shop_id`. |


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