Arguments
Every argument is optional.
Without
shop_id and domain, the feed covers every store you track. Pass one of them, not both: a call with both, or a since date outside the last 30 days, returns invalid_arguments. A store you do not track returns shop_not_tracked, and so does a call while you track no store yet. None of these errors costs a credit.
Event types
Changes appear once Copyfy has checked the store again. A new ad keeps its start date even when Copyfy finds it a few days later, so a narrow
since window can come back empty: widen it, up to 30 days back.
Example
The changes of the last week, three events per page:Tool call
Result (trimmed)
Result fields
Each event has:
Pass a product
id to get_product. Store names, product titles, and ad copy are third-party content.
Narrow a busy feed
Prices change per variant, so a store running a sale can fill several pages withprice_changed events. Read counts_by_type, then narrow with event_types (for example ["new_ad"]), shop_id, or a later since. Pages stop at 20, so at most 500 events of a window are reachable with 25 events per page. If a page exceeds 64 KiB, the call returns result_too_large without charging a credit: request fewer events per page.