{
"openapi": "3.0.1",
"info": {
"title": "Depop Scraper",
"description": "Search and extract Depop product listings with prices, brands, sizes, condition, seller info, and images. Filter by price and region. Fast, reliable, pay per result.",
"version": "0.2",
"x-build-id": "fw63rAEi51UIcjxOt"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/apium~depop-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-apium-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/apium~depop-scraper/runs": {
"post": {
"operationId": "runs-sync-apium-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/apium~depop-scraper/run-sync": {
"post": {
"operationId": "run-sync-apium-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 queries",
"uniqueItems": true,
"type": "array",
"description": "Keywords to search on Depop, one per line — e.g. carhartt jacket, vintage levis 501. Each query is scraped up to Max items (shared cap across all sources).",
"items": {
"type": "string"
}
},
"searchUrls": {
"title": "Search / category URLs",
"uniqueItems": true,
"type": "array",
"description": "Full depop.com search or category URLs copied from your browser — filters in the URL (price, condition, brand, sort, category path) are parsed and applied automatically. Example: https://www.depop.com/search/?q=carhartt&priceMax=40&sort=newlyListed",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"shopUsernames": {
"title": "Shop usernames",
"uniqueItems": true,
"type": "array",
"description": "Depop shop usernames to scrape entire shops — e.g. vintagefinds_uk. You can also paste full shop URLs like https://www.depop.com/vintagefinds_uk/; the username is extracted automatically.",
"items": {
"type": "string"
}
},
"productUrls": {
"title": "Product URLs",
"uniqueItems": true,
"type": "array",
"description": "Individual Depop product URLs to fetch full details for — e.g. https://www.depop.com/products/username-vintage-nike-hoodie/",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"type": "integer",
"description": "Hard cap on the total number of results pushed to the dataset (and therefore the maximum you pay for). The run stops as soon as this many unique products have been saved.",
"default": 500
},
"priceFrom": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Only include listings priced at or above this value (in the currency of the selected country)."
},
"priceTo": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Only include listings priced at or below this value."
},
"condition": {
"title": "Condition",
"enum": [
"any",
"brand_new",
"used_like_new",
"used_excellent",
"used_good",
"used_fair"
],
"type": "string",
"description": "Filter search results by item condition.",
"default": "any"
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"newest",
"price_low_to_high",
"price_high_to_low"
],
"type": "string",
"description": "Order of search results. 'Newest first' is ideal for monitoring fresh listings.",
"default": "relevance"
},
"country": {
"title": "Country / marketplace",
"enum": [
"us",
"gb",
"au",
"ca",
"de",
"fr",
"it",
"ie",
"nl",
"es",
"nz"
],
"type": "string",
"description": "Depop marketplace to search. Determines result availability and price currency.",
"default": "us"
},
"fullItemDetails": {
"title": "Fetch full product details",
"type": "boolean",
"description": "When enabled, every search/shop result triggers one extra request to the product detail endpoint to fill in description, condition, seller_rating and timestamps. Slower and uses more proxy traffic — leave off for pure price/brand research.",
"default": false
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Datacenter proxies are the default and work for Depop in most cases — they are the cheapest option. Only switch to residential here if you know you need it; otherwise leave this alone and rely on the automatic residential fallback below.",
"default": {
"useApifyProxy": true
}
},
"useResidentialFallback": {
"title": "Residential fallback on blocking",
"type": "boolean",
"description": "If datacenter proxies get repeatedly blocked (HTTP 403), automatically retry the affected requests through Apify residential proxies. Residential traffic costs more per GB — this scraper transfers only small JSON payloads, so the impact is minor, but you can disable escalation entirely for full cost control.",
"default": true
},
"minPrice": {
"title": "Min price (legacy)",
"type": "integer",
"description": "Deprecated alias of priceFrom."
},
"maxPrice": {
"title": "Max price (legacy)",
"type": "integer",
"description": "Deprecated alias of priceTo."
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}