Skip to main content
Returns what changed recently in the stores you track in Copyfy, newest first: Meta ads that started or stopped running, products added or removed, price changes, and product updates. It combines the New ads and Updates tabs of Shop Analysis in the dashboard, for every tracked store or for one of them. Use it for questions such as “What is new at my competitors this week?”. Reading the feed marks nothing as seen: the New ads counter in the dashboard does not change. Cost: 1 credit per successful call.

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 with price_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.