type says what the link points to: shop, product, or ad. Use it when you have a link instead of a Copyfy id.
Cost: 1 credit per successful call.
Arguments
Supported links
Product URLs also work behind a collection or market prefix, such as
/collections/dogs/products/<handle> or /fr/products/<handle>. Copyfy ignores query strings and tracking parameters (utm_source, fbclid, variant, and so on), except the id of an Ad Library link.
Product links
Product details follow the same access rule asget_product: they are returned for stores you track in Copyfy and for your own brand stores. For other stores, the result has the product’s short sheet (id, title, url, currency, price_min, price_max, the main image, dates, shop and dashboard_url), the store as get_shop returns it, and product_details_require_tracking: true. Track the store from its dashboard_url, then call get_product with the product id. The MCP never uses your tracking slots on its own.
Example
Tool call
Result for an ad (trimmed)
Result for a product of a store you do not track (trimmed)
Result fields
Unlike
search_ads, lookup also returns ads whose media Copyfy has not stored yet: video_url is then null, and image_url can be a Meta link that expires within days.
Errors
A link in another format, such as free text, a Facebook page, or a Copyfy page other than a shop page, returnsinvalid_arguments with the supported_formats. A store, product, or ad that Copyfy does not know returns not_found. For a product of a store Copyfy knows, the error includes the store’s shop_id and dashboard_url. Refused calls are free.