{
  "openapi": "3.0.1",
  "info": {
    "title": "Depop Scraper - Listings, Sold Items, Shops & Reviews",
    "description": "Scrape Depop listings in 16 countries by keyword, search, category, brand, shop or product URL with Depop's filters: price, fees, shipping, brand, size, condition, colours, photos, likes, seller. Sold items, item details, seller profiles, reviews. $0.81 per 1,000 listings, no login.",
    "version": "0.1",
    "x-build-id": "CV2ixAHaeFSgUStJI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~depop-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-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/topapi~depop-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-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/topapi~depop-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-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": {
          "searchQueries": {
            "title": "🔍 Search keywords",
            "type": "array",
            "description": "What you would type in Depop's search box, one per line, e.g. \"nike\", \"carhartt jacket\", \"levis 501\". Depop URLs work here too.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "🌍 Country",
            "enum": [
              "us",
              "gb",
              "au",
              "ca",
              "nz",
              "ie",
              "fr",
              "de",
              "it",
              "es",
              "nl",
              "be",
              "at",
              "fi",
              "dk",
              "se"
            ],
            "type": "string",
            "description": "The Depop market keywords are searched in. Prices come in that market's currency. URLs with a country prefix (depop.com/gb/...) keep their own.",
            "default": "us"
          },
          "countries": {
            "title": "Several countries",
            "type": "array",
            "description": "Search each keyword in several markets in one run: codes such as us, gb, au, ca, fr, de (overrides the country above for keywords).",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Depop URLs",
            "type": "array",
            "description": "Search pages with their filters (depop.com/search/?q=…&brands=…&sizes=…), category pages (/category/mens/tops/tshirts/), brand pages (/brands/nike/), shop pages (depop.com/<username>/) and product pages (/products/…).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "urlsFromFile": {
            "title": "URLs from a file",
            "type": "string",
            "description": "Many URLs at once: paste them one per line, or one link to a .txt / .csv file that lists them."
          },
          "shops": {
            "title": "🏪 Shops",
            "type": "array",
            "description": "Depop shop usernames, shop URLs or numeric user ids: every listing in the shop (see Shop listings for sold items).",
            "items": {
              "type": "string"
            }
          },
          "productUrls": {
            "title": "🏷️ Products",
            "type": "array",
            "description": "Depop product URLs, slugs or numeric ids: each product's full record, seller and seller stats included.",
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "price-asc",
              "price-desc"
            ],
            "type": "string",
            "description": "Depop's order. Newest-first is shown by Depop only to signed-in members, so it is not offered.",
            "default": "relevance"
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Brand names (\"Nike\", \"Levi's\", \"Carhartt WIP\") or Depop brand ids (270). Names are matched with Depop's own brand list.",
            "items": {
              "type": "string"
            }
          },
          "department": {
            "title": "Department",
            "enum": [
              "any",
              "womens",
              "mens",
              "kids"
            ],
            "type": "string",
            "description": "Depop's women / men / kids departments.",
            "default": "any"
          },
          "gender": {
            "title": "Gender",
            "enum": [
              "any",
              "female",
              "male",
              "unisex"
            ],
            "type": "string",
            "description": "Gender attribute of the listing (overrides Department for gender).",
            "default": "any"
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Depop groups or product types, e.g. tops, bottoms, coats-jackets, footwear, dresses, tshirts, hoodies, jeans, trainers, bag.",
            "items": {
              "type": "string"
            }
          },
          "sizes": {
            "title": "Size ids",
            "type": "array",
            "description": "Depop size ids as they appear in a search URL's sizes= value, e.g. 4.17 or 4.17-US (several sizes OK).",
            "items": {
              "type": "string"
            }
          },
          "conditions": {
            "title": "Condition",
            "type": "array",
            "description": "Keep listings in these conditions only.",
            "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": "black, grey, white, brown, tan, cream, yellow, red, burgundy, orange, pink, purple, blue, navy, green, khaki, silver, gold, multi.",
            "items": {
              "type": "string"
            }
          },
          "priceMin": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "In the market's currency."
          },
          "priceMax": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "In the market's currency."
          },
          "onlyDiscounted": {
            "title": "On sale only",
            "type": "boolean",
            "description": "Only listings with a price reduction.",
            "default": false
          },
          "includeKeywords": {
            "title": "Must contain",
            "type": "array",
            "description": "Keep a listing only if its description or brand contains one of these words (checked before the charge).",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Must not contain",
            "type": "array",
            "description": "Drop a listing whose description or brand contains one of these words (checked before the charge).",
            "items": {
              "type": "string"
            }
          },
          "shopListings": {
            "title": "Shop listings",
            "enum": [
              "active",
              "sold",
              "both"
            ],
            "type": "string",
            "description": "Which tab of each shop to read. Sold items carry the sold date.",
            "default": "active"
          },
          "includeLikedItems": {
            "title": "Liked items",
            "type": "boolean",
            "description": "Also return the listings each shop has liked (when the shop shows them).",
            "default": false
          },
          "maxLikedItemsPerShop": {
            "title": "Max liked items per shop",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on liked-item rows per shop.",
            "default": 100
          },
          "fetchDetails": {
            "title": "Item details",
            "type": "boolean",
            "description": "For search rows: the seller's username, verified badge, country and avatar, seller rating, review count, items sold, last active and average shipping days, plus every attribute label. Shop and product rows carry seller fields already.",
            "default": false
          },
          "includeSellerProfiles": {
            "title": "Seller profiles",
            "type": "boolean",
            "description": "One row per shop: username, name, bio, website, verified, followers, following, rating, reviews, items sold, last active; its fields are copied onto that seller's listings.",
            "default": false
          },
          "includeReviews": {
            "title": "Shop reviews",
            "type": "boolean",
            "description": "One row per review of each shop given above: rating, text, date, reviewer, product.",
            "default": false
          },
          "reviewRole": {
            "title": "Reviews received as",
            "enum": [
              "seller",
              "buyer",
              "both"
            ],
            "type": "string",
            "description": "Reviews the shop received as a seller, as a buyer, or both.",
            "default": "seller"
          },
          "maxReviewsPerShop": {
            "title": "Max reviews per shop",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Cap on review rows per shop and role.",
            "default": 50
          },
          "includeSimilar": {
            "title": "Similar items",
            "type": "boolean",
            "description": "For products given above: also return Depop's similar listings (up to 24 each).",
            "default": false
          },
          "maxItems": {
            "title": "Max listings",
            "minimum": 0,
            "type": "integer",
            "description": "Listing rows in total across every search, shop and product (0 = no limit). Seller and review rows do not count here.",
            "default": 100
          },
          "maxItemsPerSearch": {
            "title": "Max listings per search or shop",
            "minimum": 0,
            "type": "integer",
            "description": "Cap for each keyword, URL or shop, so one target cannot use the whole run."
          },
          "monitorMode": {
            "title": "Monitor mode",
            "type": "boolean",
            "description": "Return only listings not delivered by earlier runs with the same monitor name (searches read their first page(s); shops stop at the first page with nothing new).",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Named key-value store that remembers what was delivered. Use one name per watch list.",
            "default": "depop-monitor"
          },
          "monitorPages": {
            "title": "Pages per search on a poll",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many result pages (100 listings each) a monitor poll reads per search.",
            "default": 1
          },
          "alertOnPriceDrop": {
            "title": "Also return price drops",
            "type": "boolean",
            "description": "Deliver a listing seen before when its price fell (changeType = price_drop, with previousPrice).",
            "default": false
          },
          "minPriceDropPct": {
            "title": "Minimum price drop %",
            "minimum": 0,
            "maximum": 95,
            "type": "integer",
            "description": "Only price drops of at least this percent are returned.",
            "default": 0
          },
          "skipFirstRun": {
            "title": "Skip first run",
            "type": "boolean",
            "description": "The first monitor run only remembers what is listed now (nothing delivered, nothing charged); later runs return what is new.",
            "default": false
          },
          "resetMonitor": {
            "title": "Reset monitor memory",
            "type": "boolean",
            "description": "Forget what this monitor name delivered before (the next run returns everything again).",
            "default": false
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POSTed once per run with the new listings (JSON)."
          },
          "webhookHeaders": {
            "title": "Webhook headers",
            "type": "object",
            "description": "Extra headers for the webhook POST, e.g. {\"Authorization\": \"Bearer ...\"}."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "A Discord channel webhook: one message per run with the new listings."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "A Slack incoming webhook: one message per run with the new listings."
          },
          "telegramToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Bot token from @BotFather (kept secret)."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "The chat the bot posts to."
          },
          "notificationLimit": {
            "title": "Listings per alert",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Listings named in each alert message.",
            "default": 10
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "Parallel requests for item details and seller profiles.",
            "default": 4
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Depop refuses Apify's own server, datacenter and residential IPs, so by default each request ends on Apify's unblocking proxy. Your own proxy URLs are used first when given (item details, seller profiles and product URLs then have no per-run limit).",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}