search_products

Searches Copyfy Top Products with the same filters and ranking as the Products page of the dashboard. Each result includes the product, the estimated revenue, orders, and traffic of its store, and a link to the store in Copyfy. 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. Product-specific arguments:

Argument	Type	Allowed values
`price`	range	Product price, in the store’s currency.
`sort_by`	enum	`recommended` (Copyfy relevance score used by the dashboard), `revenue`, `orders`, `traffic`, `traffic_growth`, `active_ads` (all five rank by the store’s figures), `price`, `newest`. Default: `recommended`.
`sort_order`	enum	`asc`, `desc`. Default: `desc`. Keep `desc` with `sort_by: "recommended"` to get the best products first.

Niche names resolve like the dashboard filter. An unknown niche returns invalid_arguments with a hint to call list_filter_options.

Example

Top 5 products in the Pets niche from US stores making at least $10,000 a month, sorted by store revenue:

Tool call

{
  "name": "search_products",
  "arguments": {
    "niches": ["Pets"],
    "countries": ["US"],
    "monthly_revenue": { "min": 10000 },
    "sort_by": "revenue",
    "per_page": 5
  }
}

Result (trimmed)

{
  "results": [
    {
      "id": 48213377,
      "title": "Self-Cleaning Slicker Brush",
      "url": "https://example-pet-store.com/products/self-cleaning-slicker-brush",
      "image_url": "https://cdn.shopify.com/s/files/1/example/brush.jpg",
      "price": 24.99,
      "currency": "USD",
      "created_at": "2026-03-02T09:14:00.000Z",
      "shop": {
        "id": 902114,
        "name": "Example Pet Store",
        "domain": "example-pet-store.com",
        "country": "US",
        "estimated_monthly_revenue": 214800,
        "estimated_monthly_orders": 8595,
        "monthly_visits": 184000,
        "traffic_growth_pct": 18.4,
        "active_ads": 37,
        "is_tracked": false
      },
      "dashboard_url": "https://app.copyfy.io/dashboard/track/902114"
    }
  ],
  "pagination": { "page": 1, "per_page": 5, "total": 412, "has_more": true }
}

Result fields

Field	Type	Description
`id`	integer	Copyfy product id. Pass it to `get_product`.
`title`	string	Product title (third-party content).
`url`	string or null	Product page on the store.
`image_url`	string or null	Main product image.
`price`	number	Lowest variant price, in `currency`.
`currency`	string or null	Store currency (ISO 4217).
`created_at`	string or null	Date the product was created on the store (ISO 8601).
`shop`	object	The store that sells the product: `id`, `name`, `domain`, `country`, and its estimates below. Pass `shop.id` to `get_shop`.
`shop.estimated_monthly_revenue`	number or null	Estimated monthly revenue of the store.
`shop.estimated_monthly_orders`	number or null	Estimated monthly orders of the store.
`shop.monthly_visits`	number or null	Estimated monthly visits of the store.
`shop.traffic_growth_pct`	number or null	Store traffic growth score, in percent: the value the `traffic_growth_pct` filter and the `traffic_growth` sort use.
`shop.active_ads`	integer	Active Meta ads of the store.
`shop.is_tracked`	boolean	`true` when you track the store in Copyfy, so `get_product` can return the product’s details. `get_product` also works for your own brand stores.
`dashboard_url`	string	The store’s page in Copyfy.

Copyfy does not estimate sales per product. Revenue, orders, traffic, growth, and active ads are store-level estimates, so they sit under shop, and products from the same store share them. The revenue, orders, traffic, growth, and active ads filters and sort options apply to these store figures too. pagination.has_more is false on page 20, the last page you can request. 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

search_products

Arguments

Example

Result fields

​Arguments

​Example

​Result fields

Arguments

Example

Result fields