dupe

---
name: dupe
description: Uses dupe.com APIs in order to find similar products for the product found in the input URL given by the user.
compatibility: Requires curl, access to the internet.
metadata:
  author: dupe.com
  version: '1.0'
---

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