Arguments
Every argument is optional. Withoutniches and countries, the radar uses the niches and countries most common among the stores you track in Copyfy, and says so in inferred_from.
An unknown niche, or a
since date outside the last 7 days, returns invalid_arguments without charging a credit.
Example
A radar based on the stores you track, two items per list:Tool call
Result (trimmed)
How each list is built
Dates are in UTC. Products and ads appear once Copyfy has collected and indexed them, so a one-day window can return an empty list: widen
since, up to 7 days back.
Result fields
Store names, product titles, and ad copy are third-party content.
When a list is unavailable
If one search is temporarily unavailable, its list returnsitems: [] and an error object with a code and a message, and the other lists still load. The call then costs 1 credit. If the lists that did load are empty, or all three searches fail, the call fails without charging a credit, with search_unavailable when the search engine is down.
If Copyfy cannot read the stores you track, the call returns service_unavailable without charging a credit. Retry, or pass niches or countries.
The radar stays under the 64 KiB result limit: when long links would push it over, the heaviest list drops its last items and sets has_more to true.