{ "openapi": "3.0.1", "info": { "title": "Depop Scraper", "description": "Scrape public Depop listings by keyword or product URL with prices, brands, sizes, images, seller stats, and detail enrichment. MCP-ready.", "version": "0.1", "x-build-id": "ce5DLbwxh0LaYN6mK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~depop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~depop-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~depop-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": "Scrape mode", "enum": [ "search", "productUrls" ], "type": "string", "description": "Choose how the actor finds Depop listings. Use 'search' to scrape public search results for one or more keywords, or 'productUrls' to enrich specific Depop product URLs. Defaults to 'search'. This is not a seller review scraper or a login-based shop manager.", "default": "search" }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Depop search terms to scrape in search mode, for example 'vintage levis' or 'y2k baby tee'. Each keyword is run separately and results are deduped by product URL. Defaults to 'vintage levis'. This is not a full-site crawl or authenticated saved search.", "default": [ "vintage levis" ], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Direct Depop product URLs to enrich in productUrls mode, for example 'https://www.depop.com/products/shopname-item-slug/'. Multiple URLs are supported and are deduped before scraping. Leave empty in search mode. This does not accept generic website URLs.", "default": [], "items": { "type": "string" } }, "country": { "title": "Marketplace country", "enum": [ "us", "gb", "au", "ca", "ie", "de", "fr", "it", "es", "nl", "be", "nz" ], "type": "string", "description": "Country context for Depop search results and pricing, using lowercase ISO-like market codes such as 'us' or 'gb'. Defaults to 'us'. The country also informs the currency used by search requests. This is not a shipping destination filter.", "default": "us" }, "maxItems": { "title": "Max listings", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on the number of Depop listings returned and billed across the whole run. Defaults to 10 and can be set as low as 1 for a cheap test. The actor stops charging once this cap is reached. This is not a page count.", "default": 10 }, "maxPages": { "title": "Max search pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum Depop search API pages to request per keyword when the lightweight API route is available. Each page is about 24 listings. Defaults to 1 so default runs finish quickly. If Depop challenges the API route, the actor falls back to the browser-loaded listings it can verify instead of pretending pagination worked.", "default": 1 }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Open each product page to enrich listings with full title, description, image gallery, condition, colors, seller review count, items sold, and shipping signals. Defaults to true for richer records. Turn it off for faster keyword inventory checks. This does not log in or scrape private buyer data.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify proxy settings for Depop requests. Residential proxy is enabled by default because Depop commonly blocks Apify cloud datacenter traffic. The actor still tries the lightweight HTTP route first, then falls back to browser-rendered public listings. You can disable proxy for local tests or fixed product URLs if Depop is reachable without it.", "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 } } }, "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 } } } } } } } } } }