{
  "openapi": "3.0.1",
  "info": {
    "title": "Depop Scraper 💰 from $1.50/1K – Listings, Shops & Reviews",
    "description": "Scrape Depop listings, full product details, whole shops and seller reviews across 9 marketplaces (UK, US, EU, AU, CA, NZ). Search by keyword or paste any depop.com URL; filter by price, brand, size, colour and condition. Monitoring mode returns only new listings for resale alerts. No login.",
    "version": "0.0",
    "x-build-id": "rcR6hV6ixiuBeL9ct"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lukass~depop-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lukass-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/lukass~depop-scraper/runs": {
      "post": {
        "operationId": "runs-sync-lukass-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/lukass~depop-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-lukass-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",
        "required": [
          "proxy"
        ],
        "properties": {
          "search": {
            "title": "Search keywords",
            "type": "array",
            "description": "Keywords to search for, one per line.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Depop URLs",
            "type": "array",
            "description": "depop.com URLs to scrape. Product, search, category and shop URLs are supported, and any filters in the URL are applied. Brand landing pages are not.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "sellers": {
            "title": "Shops",
            "type": "array",
            "description": "Depop shop usernames or numeric user ids. Scrapes each shop's listings.",
            "items": {
              "type": "string"
            }
          },
          "searchSellers": {
            "title": "Find shops by keyword",
            "type": "array",
            "description": "Keywords to search Depop shops for. Every matching shop is then scraped like one you named directly.",
            "items": {
              "type": "string"
            }
          },
          "maxSellersPerQuery": {
            "title": "Max shops per keyword",
            "type": "integer",
            "description": "How many shops to take from each shop-search keyword.",
            "default": 10
          },
          "country": {
            "title": "Marketplace",
            "enum": [
              "gb",
              "us",
              "au",
              "nz",
              "ca",
              "de",
              "fr",
              "ie",
              "it"
            ],
            "type": "string",
            "description": "Which regional marketplace to search. Also sets the currency prices are quoted in.",
            "default": "gb"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "priceAsc",
              "priceDesc"
            ],
            "type": "string",
            "description": "Order of the search results. 'Newly listed' is the one to use for monitoring fresh listings.",
            "default": "relevance"
          },
          "priceMin": {
            "title": "Min price",
            "type": "integer",
            "description": "Lowest listing price to include, in the marketplace currency. Applies to the item price before tax."
          },
          "priceMax": {
            "title": "Max price",
            "type": "integer",
            "description": "Highest listing price to include, in the marketplace currency. Applies to the item price before tax."
          },
          "condition": {
            "title": "Condition",
            "type": "array",
            "description": "Item conditions to include.",
            "items": {
              "type": "string",
              "enum": [
                "brand_new",
                "used_like_new",
                "used_excellent",
                "used_good",
                "used_fair"
              ],
              "enumTitles": [
                "Brand new",
                "Like new",
                "Excellent",
                "Good",
                "Fair"
              ]
            }
          },
          "colours": {
            "title": "Colours",
            "type": "array",
            "description": "Colour slugs, e.g. black, white, blue, red, green, pink, brown, tan, grey.",
            "items": {
              "type": "string"
            }
          },
          "brands": {
            "title": "Brand IDs",
            "type": "array",
            "description": "Numeric brand ids, e.g. 270 for Nike. Brand names are not accepted by the API.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Category IDs",
            "type": "array",
            "description": "Numeric category ids, e.g. 10 for womenswear bottoms. A parent id also matches everything below it.",
            "items": {
              "type": "string"
            }
          },
          "groups": {
            "title": "Groups",
            "type": "array",
            "description": "Department group slugs, e.g. tops, bottoms, dresses, footwear, accessories, coats-jackets.",
            "items": {
              "type": "string"
            }
          },
          "productTypes": {
            "title": "Product types",
            "type": "array",
            "description": "Product type slugs within a group, e.g. jeans, tshirts, hoodies.",
            "items": {
              "type": "string"
            }
          },
          "sizes": {
            "title": "Size IDs",
            "type": "array",
            "description": "Composite size ids in the form variantSetId.variantId, e.g. 22.5. Size ids are specific to a category's size set.",
            "items": {
              "type": "string"
            }
          },
          "gender": {
            "title": "Gender",
            "enum": [
              "male",
              "female",
              "unisex"
            ],
            "type": "string",
            "description": "Filter by the department a listing is sold under."
          },
          "isKids": {
            "title": "Kidswear only",
            "type": "boolean",
            "description": "Return only kidswear listings.",
            "default": false
          },
          "onlyDiscounted": {
            "title": "Discounted items only",
            "type": "boolean",
            "description": "Return only listings whose price has been reduced.",
            "default": false
          },
          "monitoringMode": {
            "title": "Monitoring mode (only new listings)",
            "type": "boolean",
            "description": "Return only listings that earlier runs of this same search have not returned yet, so a scheduled run pays only for what is new. Searches are sorted by 'Newly listed' and stop at the first page with nothing new. Shop reviews are monitored the same way. Pasted product URLs are always returned. Changing the keywords, URLs, shops or filters starts a fresh list.",
            "default": false
          },
          "fetchDetails": {
            "title": "Fetch full product details",
            "type": "boolean",
            "description": "One extra request per listing, adding condition, colour, group, product type, seller username, likes and comment counts. Turn off for a cheaper, shallower run.",
            "default": true
          },
          "includeSellerDetails": {
            "title": "Include seller profile",
            "type": "boolean",
            "description": "Adds the seller's rating, review count, items sold and follower counts. One extra request per seller, cached across their items.",
            "default": false
          },
          "includeSellerReviews": {
            "title": "Scrape seller reviews",
            "type": "boolean",
            "description": "For each shop, also scrape its reviews as separate dataset records.",
            "default": false
          },
          "reviewRoles": {
            "title": "Review roles",
            "type": "array",
            "description": "Whether to scrape reviews the user received as a seller, as a buyer, or both.",
            "items": {
              "type": "string",
              "enum": [
                "seller",
                "buyer"
              ],
              "enumTitles": [
                "As seller",
                "As buyer"
              ]
            },
            "default": [
              "seller"
            ]
          },
          "includeSoldItems": {
            "title": "Include sold items in shops",
            "type": "boolean",
            "description": "When scraping a shop, also return items that are no longer on sale.",
            "default": false
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Stop after this many dataset records. The allowance is split evenly between sources (each keyword, URL and shop); a source that runs out early hands its remainder to the others. Leave empty for no limit."
          },
          "maxPagesPerSource": {
            "title": "Max pages per source",
            "type": "integer",
            "description": "Pagination cap per keyword, URL or shop. 100 listings per page. Leave empty for no limit."
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Depop blocks datacenter IPs, so Apify Proxy always uses residential IPs, from the marketplace's country unless you pick a country here. Proxy costs are included in the price.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}