Skip to main content
Resolves a link to its record in Copyfy, so you can paste a store, a product page, or a Meta ad and get its data in one call. The result’s 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

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 details follow the same access rule as get_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, returns invalid_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.