credits_used in the response states what the call cost.
In apps that support MCP Apps, such as Claude and ChatGPT, the results also appear as a carousel of product cards: image, price, store, store estimate, and an Open in Copyfy button. The JSON is the same in every client.
Arguments
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:
On this tool,
query is matched word by word against product titles, URL handles, and store names, in each store’s own language. Most indexed stores write in English, so use the English product term unless you filter on a language or market whose stores write in another language; then use that language’s term. One or two product-type words work best, and typos are tolerated.
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
Result (trimmed)
query must be in the product. When no product has them all, Copyfy returns the products that match some of the words, with match: "partial" and a notice; these results are not exact matches.
Result fields
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 call returns result_too_large without charging a credit or dropping items. Narrow the filters to recover later matches, or restart pagination with a smaller per_page and deduplicate earlier results. The 20-page limit still applies, so a smaller page size reduces the reachable results.
Empty results and translated keywords
A search that returns no results is free ("credits_used": 0). When page 1 is empty, zero_result_help explains why and notice gives the assistant a sentence to act on. Copyfy never removes one of your filters on its own: the assistant should ask you which one to relax.
When the keyword matches no product title in the markets you selected, Copyfy translates it once, to English or to the language you filter on when you filter on exactly one, and runs the same search with every filter unchanged. If the translated keyword finds products, the response returns them with query_rewrite, and the call costs 1 credit like any search with results. If it finds nothing either, its counts appear in zero_result_help.translated_query and the call stays free. Pass exact_query: true to search only the words you typed.
Result with a translated keyword (trimmed)
Empty result (counts are illustrative)
A count is
null when its check did not finish in time.