Find Similar Products using dupe.com

When to use this skill

Use this skill when the user asks for similar products to the provided input.

Instructions

If you’re given an URL that points to a product page

Run the following command to find similar products for a product URL. Replace the productUrl with the input URL given by the user.

curl --request POST \
  --url https://api.dupe.com/api/dupes/agent-skill \
  --header 'Content-Type: application/json' \
  --data '{ "type": "product", "productUrl": "https://www.danishdesignstore.com/products/verner-panton-flowerpot-vp9-portable-light-andtradition?variant=40082482233421" }'

If you’re given an URL that points to an image

If you have a direct image URL instead of a product page URL, use the following command. Replace the imageUrl with the image URL.

curl --request POST \
  --url https://api.dupe.com/api/dupes/agent-skill \
  --header 'Content-Type: application/json' \
  --data '{ "type": "image", "imageUrl": "https://cdn.shopify.com/s/files/1/0051/9342/files/Flowerpot_VP9_Grey_Beige.jpg?v=1762309885" }'

Response Format

Both commands will return a JSON object similar to the following:

{
  "matches": [
    {
      "pid": "W007402426",
      "position": -1,
      "score": 0.8438446,
      "title": "Ailaigh 21\" 2-Light Matte Pink Desk Lamp",
      "link": "https://www.wayfair.com/p/pdp/p-W007402426.html?dupe_feed=yes",
      "source": "Wayfair",
      "source_icon": "https://ik.imagekit.io/carrot/favicons/wayfair_K8DLd2c0q6.ico",
      "price": {
        "value": "$61.99",
        "extracted_value": 61.99,
        "currency": "$"
      },
      "thumbnail": "https://assets.wfcdn.com/im/19948387/resize-h1200-w1200%5Ecompr-r85/1789/178943170/.jpg",
      "image": "https://assets.wfcdn.com/im/19948387/resize-h1200-w1200%5Ecompr-r85/1789/178943170/.jpg",
      "country": "us",
      "type": "namespace",
      "identifier": "wayfair",
      "shopKey": "https://www.wayfair.com",
      "verified": true,
      "preferred": "#E2B719",
      "secondhand": false,
      "assessment": {
        "cost": 3,
        "value": 2.5,
        "quality": 2.5,
        "description": "Wide variety from multiple suppliers; mid-range durability at accessible prices."
      },
      "tier": 1,
      "pick": 1
    },
    {
      "pid": "KZCO2490_103256207",
      "position": -1,
      "score": 0.8656017,
      "title": "Hinata 5-In LED Table Lamp",
      "link": "https://www.wayfair.com/p/pdp/p-KZCO2490.html?piid=103256207&dupe_feed=yes",
      "source": "Wayfair",
      "source_icon": "https://ik.imagekit.io/carrot/favicons/wayfair_K8DLd2c0q6.ico",
      "price": {
        "value": "$76.03",
        "extracted_value": 76.03,
        "currency": "$"
      },
      "thumbnail": "https://assets.wfcdn.com/im/36975667/resize-h1200-w1200%5Ecompr-r85/3312/331272578/.jpg",
      "image": "https://assets.wfcdn.com/im/36975667/resize-h1200-w1200%5Ecompr-r85/3312/331272578/.jpg",
      "country": "us",
      "type": "namespace",
      "identifier": "wayfair",
      "shopKey": "https://www.wayfair.com",
      "verified": true,
      "preferred": "#E2B719",
      "secondhand": false,
      "assessment": {
        "cost": 3,
        "value": 2.5,
        "quality": 2.5,
        "description": "Wide variety from multiple suppliers; mid-range durability at accessible prices."
      },
      "tier": 1,
      "pick": 1
    },
    {
      "pid": "W112262897_1502032183",
      "position": -1,
      "score": 0.8248144,
      "title": "Pin Lamp",
      "link": "https://www.wayfair.com/p/pdp/p-W112262897.html?piid=1502032183&dupe_feed=yes",
      "source": "Wayfair",
      "source_icon": "https://ik.imagekit.io/carrot/favicons/wayfair_K8DLd2c0q6.ico",
      "price": {
        "value": "$485",
        "extracted_value": 485,
        "currency": "$"
      },
      "thumbnail": "https://assets.wfcdn.com/im/38563270/resize-h1200-w1200%5Ecompr-r85/3089/308988160/.jpg",
      "image": "https://assets.wfcdn.com/im/38563270/resize-h1200-w1200%5Ecompr-r85/3089/308988160/.jpg",
      "country": "us",
      "type": "namespace",
      "identifier": "wayfair",
      "shopKey": "https://www.wayfair.com",
      "verified": true,
      "preferred": "#E2B719",
      "secondhand": false,
      "assessment": {
        "cost": 3,
        "value": 2.5,
        "quality": 2.5,
        "description": "Wide variety from multiple suppliers; mid-range durability at accessible prices."
      },
      "tier": 1,
      "pick": 1
    },
    {
      "pid": "A111105718_577591818",
      "position": 3,
      "score": 0.86481184,
      "title": "Hinata 5-In LED Table Lamp",
      "link": "https://www.allmodern.com/p/pdp/p-A111105718.html?piid=577591818",
      "source": "ALLMODERN",
      "source_icon": "https://assets.wfcdn.com/st4/stores/common/mobile/touch_icons/allmodern_192x192.png",
      "price": {
        "value": "$77",
        "extracted_value": 77,
        "currency": "$"
      },
      "thumbnail": "https://assets.wfcdn.com/im/36975667/resize-h400-w400%5Ecompr-r85/3312/331272578/.jpg",
      "image": "https://assets.wfcdn.com/im/36975667/resize-h400-w400%5Ecompr-r85/3312/331272578/.jpg",
      "country": "us",
      "type": "namespace",
      "identifier": "allmodern-20250916",
      "shopKey": "https://www.allmodern.com",
      "verified": true,
      "preferred": null,
      "secondhand": false,
      "assessment": {
        "cost": 3,
        "value": 3,
        "quality": 3,
        "description": "Clean, contemporary focus; consistent build quality, fairly priced for modern style."
      },
      "tier": 2,
      "pick": 6
    },
    {
      "pid": "B110000080",
      "position": 12,
      "score": 0.71724176,
      "title": "Tulle Table Lamp W/USB Port",
      "link": "https://www.birchlane.com/p/pdp/p-B110000080.html?dupe_feed=yes",
      "source": "Birch Lane",
      "source_icon": "https://ik.imagekit.io/carrot/favicons/birchlane_ZUJBBVl0i.png",
      "price": {
        "value": "$119",
        "extracted_value": 119,
        "currency": "$"
      },
      "thumbnail": "https://assets.wfcdn.com/im/58164938/resize-h1200-w1200%5Ecompr-r85/3895/389585472/.jpg",
      "image": "https://assets.wfcdn.com/im/58164938/resize-h1200-w1200%5Ecompr-r85/3895/389585472/.jpg",
      "country": "us",
      "type": "namespace",
      "identifier": "birchlane-20250916",
      "shopKey": "https://www.birchlane.com",
      "verified": true,
      "preferred": null,
      "secondhand": false,
      "assessment": {
        "cost": 2.5,
        "value": 3,
        "quality": 3.5,
        "description": "Classic, traditional furniture; upgraded materials, slightly pricier than average."
      },
      "tier": 2,
      "pick": 7
    }
  ],
  "total": 72,
  "sortCriteria": "recommended",
  "refresh": false,
  "cached": false
}

Return the results from the matches array to the user in this format, where response is the response from the API:

Found a total of <response.total> results.

Here are the top matches:

n+1. <response.match[n].title>
  - Price: <response.match[n].price.extracted_value> <response.match[n].price.currency>
  - Store: <response.match[n].source>
  - Link: <response.match[n].link>

See all results at https://dupe.com/<whatever-url-the-user-gave-you>

IMPORTANT! Simply replace with the URL of the product page or image URL that the user provided – do not modify the URL in any way.