dupe

# 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.

You can optionally specify a `limit` parameter (default: 7) to control how many results are returned.

```bash
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", "limit": 7 }'
```

### 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.

You can optionally specify a `limit` parameter (default 7, max 20) to control how many results are returned.

```bash
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", "limit": 10 }'
```

### Response Format

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

```json
{
  "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...