{
  "openapi": "3.0.1",
  "info": {
    "title": "Depop Scraper: Products, Sold Items, Shops & Reviews",
    "description": "Scrape Depop search results, product details, whole shops with sold items, reviews, followers and sellers. Get prices, fees, brands, sizes, condition, photos, seller username and stats. $1.20/1K products, proxy included, no login. Export JSON, CSV, Excel.",
    "version": "0.1",
    "x-build-id": "1EsIdeB5bsnoDp6k7"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/epicscrapers~depop-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-epicscrapers-depop-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/epicscrapers~depop-scraper/runs": {
      "post": {
        "operationId": "runs-sync-epicscrapers-depop-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/epicscrapers~depop-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-epicscrapers-depop-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "SEARCH",
              "PRODUCTS",
              "SELLER",
              "REVIEWS",
              "FOLLOWERS",
              "SELLER_SEARCH"
            ],
            "type": "string",
            "description": "<ul><li><strong>SEARCH</strong> — find products by keyword or search URL.</li><li><strong>PRODUCTS</strong> — full details for specific product URLs, slugs or IDs.</li><li><strong>SELLER</strong> — scrape whole shops, with optional reviews and followers.</li><li><strong>REVIEWS</strong> — scrape shop reviews and reviewer/product snapshots.</li><li><strong>FOLLOWERS</strong> — scrape followers, following, or both.</li><li><strong>SELLER_SEARCH</strong> — discover the sellers behind a keyword's search results.</li></ul>",
            "default": "SEARCH"
          },
          "searchQueries": {
            "title": "Keywords",
            "uniqueItems": true,
            "type": "array",
            "description": "Keywords to search for. Example: <code>vintage denim jacket</code>",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "searchUrls": {
            "title": "Search URLs",
            "uniqueItems": true,
            "type": "array",
            "description": "Depop search URLs; the keyword is extracted from <code>?q=</code>. Example: <code>https://www.depop.com/search/?q=nike+dunk</code>",
            "items": {
              "type": "string",
              "pattern": "^https?://(www\\.)?depop\\.com/search/?\\?.*$"
            }
          },
          "maxProductsPerQuery": {
            "title": "Max products per keyword",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of products to save per keyword. Keep low for tests; raise for deep crawls.",
            "default": 100
          },
          "includeProductDetails": {
            "title": "Fetch full product details",
            "type": "boolean",
            "description": "Also open each product page (SEARCH and SELLER modes) to add the seller username, verified badge and country, product title, style, material, era, like count, free shipping, and the seller's rating, items sold, last seen and average shipping days. Charged as one extra <em>product details</em> event per product. Off by default for faster, cheaper runs.",
            "default": false
          },
          "productUrls": {
            "title": "Product URLs",
            "uniqueItems": true,
            "type": "array",
            "description": "Depop product URLs. Example: <code>https://www.depop.com/products/nikerlina-adidas-originals-fom-quake-trainers/</code>",
            "items": {
              "type": "string",
              "pattern": "^https?://(www\\.)?depop\\.com/products/[A-Za-z0-9._-]+/?$"
            }
          },
          "productSlugs": {
            "title": "Product slugs",
            "uniqueItems": true,
            "type": "array",
            "description": "Product slugs without the URL, e.g. <code>nikerlina-adidas-originals-fom-quake-trainers</code>. You can also paste numeric product IDs here.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "productIds": {
            "title": "Product IDs",
            "uniqueItems": true,
            "type": "array",
            "description": "Numeric Depop product IDs, e.g. <code>662860586</code>.",
            "items": {
              "type": "string",
              "pattern": "^\\d+$"
            }
          },
          "includeSimilar": {
            "title": "Include similar products",
            "type": "boolean",
            "description": "Also scrape the <em>Similar items</em> shown on each product page (one extra request per product).",
            "default": false
          },
          "shopUrls": {
            "title": "Shop URLs",
            "uniqueItems": true,
            "type": "array",
            "description": "Depop shop URLs. Example: <code>https://www.depop.com/nikerlina/</code>",
            "items": {
              "type": "string",
              "pattern": "^https?://(www\\.)?depop\\.com/(@?[A-Za-z0-9._-]+)/?$"
            }
          },
          "usernames": {
            "title": "Usernames",
            "uniqueItems": true,
            "type": "array",
            "description": "Depop usernames, e.g. <code>nikerlina</code>. Can be used instead of shop URLs or together with them.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "userIds": {
            "title": "User IDs",
            "uniqueItems": true,
            "type": "array",
            "description": "Numeric Depop user IDs, e.g. <code>3138013</code>.",
            "items": {
              "type": "string",
              "pattern": "^\\d+$"
            }
          },
          "includeSellerProfile": {
            "title": "Include seller profile",
            "type": "boolean",
            "description": "Save one <code>seller</code> record per shop with bio, follower counts, ratings and avatar.",
            "default": true
          },
          "includeShopProducts": {
            "title": "Include shop products",
            "type": "boolean",
            "description": "Scrape the shop's product listings (active and/or sold, depending on the status setting below).",
            "default": true
          },
          "shopProductsStatus": {
            "title": "Product status",
            "enum": [
              "active",
              "sold",
              "both"
            ],
            "type": "string",
            "description": "Scrape the shop's <code>active</code> listings, <code>sold</code> items, or <code>both</code>.",
            "default": "active"
          },
          "maxShopProducts": {
            "title": "Max products per shop",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Maximum number of product records per shop (split between active and sold when scraping both).",
            "default": 1000
          },
          "includeReviews": {
            "title": "Include reviews",
            "type": "boolean",
            "description": "In SELLER mode, also scrape buyer/seller feedback. REVIEWS mode always includes it.",
            "default": false
          },
          "reviewsRole": {
            "title": "Reviews role",
            "enum": [
              "seller",
              "buyer",
              "both"
            ],
            "type": "string",
            "description": "Reviews where the shop acted as <code>seller</code>, as <code>buyer</code>, or <code>both</code>.",
            "default": "seller"
          },
          "maxReviewsPerShop": {
            "title": "Max reviews per shop",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of reviews per shop and role.",
            "default": 500
          },
          "includeFollows": {
            "title": "Include followers / following",
            "type": "boolean",
            "description": "In SELLER mode, also scrape follow lists. FOLLOWERS mode always includes them.",
            "default": false
          },
          "followsDirection": {
            "title": "Follow lists",
            "enum": [
              "followers",
              "following",
              "both"
            ],
            "type": "string",
            "description": "Scrape accounts that <code>follow</code> the shop (followers), accounts the shop <code>follows</code> (following), or <code>both</code>.",
            "default": "followers"
          },
          "maxFollowsPerShop": {
            "title": "Max follows per shop",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of follow records per shop and direction.",
            "default": 500
          },
          "includeLikedItems": {
            "title": "Include liked items",
            "type": "boolean",
            "description": "Scrape the products the shop has liked.",
            "default": false
          },
          "maxLikedItemsPerShop": {
            "title": "Max liked items per shop",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of liked-item records per shop.",
            "default": 200
          },
          "maxSellersPerQuery": {
            "title": "Max sellers per keyword",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Used in SELLER_SEARCH mode: maximum number of sellers to save per keyword.",
            "default": 50
          },
          "includeSellerProfiles": {
            "title": "Fetch seller stats in SELLER_SEARCH",
            "type": "boolean",
            "description": "Used in SELLER_SEARCH mode: add followers, rating, reviews and items sold to every seller found (one extra request per seller).",
            "default": true
          },
          "country": {
            "title": "Country code",
            "type": "string",
            "description": "Two-letter market country code, e.g. <code>GB</code>, <code>US</code>. Pins the proxy country and the market used for search and prices.",
            "default": "GB"
          },
          "currency": {
            "title": "Currency",
            "type": "string",
            "description": "Three-letter currency for prices, e.g. <code>GBP</code>, <code>USD</code>.",
            "default": "GBP"
          },
          "pageLimit": {
            "title": "Items per request",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Page size for API requests. Lower this if you see rate limiting.",
            "default": 24
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy settings. Residential proxy is included in the price and on by default; Depop blocks datacenter IPs.",
            "properties": {},
            "default": {
              "useApifyProxy": true,
              "groups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}