search_shops

Searches Shopify stores with the same filters and ranking as the Shops page of the dashboard. Each result includes the store’s key metrics, its top markets, and its best products. Cost: 1 credit per successful call.

Arguments

Argument	Type	Allowed values
`query`	string	Free text, matched like the search box of the dashboard page (for example product titles, store names, and domains). 1 to 200 characters.
`niches`	array of strings or integers	Niche names or ids from `list_filter_options` with `kind: "niches"`. A parent niche includes its sub-niches. Up to 20.
`countries`	array of strings	Store countries as ISO 3166-1 alpha-2 codes, for example `US`, `FR`. Up to 50.
`currencies`	array of strings	Store currencies as ISO 4217 codes, for example `USD`, `EUR`.
`languages`	array of enums	Storefront languages: `English`, `French`, `Spanish`, `German`, `Italian`, `Portuguese`, `Dutch`, `Polish`, `Norwegian`, `Swedish`, `Danish`, `Finnish`, `Chinese`, `Japanese`, `Korean`, `Arabic`, `Russian`, `Turkish`, `Hindi`, `Thai`, `Vietnamese`, `Indonesian`, `Greek`, `Czech`, `Hungarian`, `Romanian`.
`domains`	array of strings	Domain extensions, for example `.com`, `.fr`, `.co.uk`.
`pixels`	array of enums	Tracking pixels on the store: `TikTok`, `Snapchat`, `Facebook`, `Instagram`, `Google`, `Twitter`, `Pinterest`, `Reddit`, `TripleWhale`, `Applovin`.
`themes`	array of strings	Shopify theme names from `list_filter_options` with `kind: "themes"`.
`apps`	array of strings	Installed Shopify app names from `list_filter_options` with `kind: "apps"` and a `query`.
`social_networks`	array of enums	Social networks linked from the store: `Facebook`, `Instagram`, `TikTok`, `YouTube`, `Pinterest`, `Twitter`, `Snapchat`, `Reddit`.
`monthly_revenue`	range	Estimated monthly revenue, in the store’s currency.
`monthly_visits`	range	Estimated monthly visits.
`traffic_growth_pct`	range	Traffic growth score, in percent: the store’s month-over-month changes in visits, added up over the months Copyfy has on record. Accepts negative values.
`active_ads`	range	Number of currently active Meta ads.
`products_count`	range	Catalog size (number of products).
`monthly_orders`	range	Estimated monthly orders.
`shop_created_between`	date range	Store creation date: `{ "from": "YYYY-MM-DD", "to": "YYYY-MM-DD" }`. Either bound can be omitted.
`page`	integer	1 to 20. Default: `1`.
`per_page`	integer	1 to 25. Default: `10`.

A range is an object { "min": number, "max": number }. Both bounds are optional and must be zero or more, except for traffic_growth_pct. Every argument is optional: with no filters, you get the same default ranking as the dashboard. Store-specific arguments:

Argument	Type	Allowed values
`avg_price`	range	Average product price of the store, in the store’s currency.
`sort_by`	enum	`recommended`, `revenue`, `traffic`, `traffic_growth`, `active_ads`, `products_count`, `newest` (the date Copyfy discovered the store). Default: `recommended`.
`sort_order`	enum	`asc`, `desc`. Default: `desc`.

recommended is the dashboard default: without filters, a daily selection of promising stores; with filters, the Copyfy relevance score.

Example

Fastest-growing stores in France with at least 50,000 monthly visits:

Tool call

{
  "name": "search_shops",
  "arguments": {
    "countries": ["FR"],
    "monthly_visits": { "min": 50000 },
    "sort_by": "traffic_growth",
    "per_page": 5
  }
}

Result (trimmed)

{
  "results": [
    {
      "id": 731902,
      "name": "Example Maison",
      "domain": "example-maison.fr",
      "dashboard_url": "https://app.copyfy.io/dashboard/track/731902",
      "screenshot_url": "https://bucket.copyfy.io/screenshots/example-maison.jpg",
      "country": "FR",
      "currency": "EUR",
      "niches": ["Home"],
      "estimated_monthly_revenue": 128400,
      "monthly_visits": 96500,
      "traffic_growth_pct": 64.2,
      "active_ads": 41,
      "total_ads": 212,
      "products_count": 86,
      "shop_created_at": "2025-11-18T00:00:00.000Z",
      "is_tracked": false,
      "top_markets": [
        { "country": "FR", "share": 81 },
        { "country": "BE", "share": 9 }
      ],
      "best_products": [
        {
          "id": 55120931,
          "title": "Linen Duvet Set",
          "price": 89.9,
          "currency": "EUR",
          "image_url": "https://cdn.shopify.com/s/files/1/example/duvet.jpg",
          "url": "https://example-maison.fr/products/linen-duvet-set"
        }
      ]
    }
  ],
  "pagination": { "page": 1, "per_page": 5, "total": 138, "has_more": true }
}

Result fields

Field	Type	Description
`id`	integer	Copyfy store id. Pass it to `get_shop`.
`name`	string	Store name (third-party content).
`domain`	string or null	Store domain.
`dashboard_url`	string	The store’s page in Copyfy.
`screenshot_url`	string or null	Homepage screenshot.
`country`	string or null	Store country (ISO 3166-1 alpha-2).
`currency`	string or null	Store currency (ISO 4217).
`niches`	array of strings	Copyfy niches of the store.
`estimated_monthly_revenue`	number or null	Estimated monthly revenue.
`monthly_visits`	number or null	Estimated monthly visits.
`traffic_growth_pct`	number or null	Traffic growth score, in percent: the value the `traffic_growth_pct` filter and the `traffic_growth` sort use. It can differ from the growth badge in the dashboard, which is measured on the chart.
`active_ads`	integer	Currently active Meta ads.
`total_ads`	integer	All Meta ads seen for the store.
`products_count`	integer	Catalog size.
`shop_created_at`	string or null	Store creation date (ISO 8601).
`is_tracked`	boolean	`true` when you track the store in Copyfy, so `get_shop` returns its analytics and `get_product` its products (`get_product` also works for your own brand stores).
`top_markets`	array	Up to 5 `{ country, share }` entries: where the store’s traffic comes from, with `share` in percent. Markets under 0.5% are left out.
`best_products`	array	Up to 3 `{ id, title, price, currency, image_url, url }` entries. Pass `id` to `get_product`.

If a search with an app or store creation date filter finds nothing, the result includes a notice: these index fields can lag behind Copyfy’s database, so retry without those filters or check the dashboard before you conclude that no store matches. If the page exceeds 64 KiB, the last items are dropped and the result includes "truncated": true.

Get started

Connect a client

Account

Tools reference

Guides

Help

Arguments

Example

Result fields

​Arguments

​Example

​Result fields

Arguments

Example

Result fields