credits_used in the response states what the call cost.
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.
Store-specific arguments:
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
Result (trimmed)
Result fields
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 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.