{ "openapi": "3.0.1", "info": { "title": "DHL Parcel Prices Scraper", "description": "Scrape DHL Germany parcel and packet list prices from dhl.de page URLs: product, price in EUR, max weight and dimensions, tracking and liability flags and order link. The default page gives 7 domestic products; the international price page adds destination and zone.", "version": "0.0", "x-build-id": "lsGp64Vy7i4Oc1kGA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~dhl-parcel-prices-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-dhl-parcel-prices-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/axiomworks~dhl-parcel-prices-scraper/runs": { "post": { "operationId": "runs-sync-axiomworks-dhl-parcel-prices-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/axiomworks~dhl-parcel-prices-scraper/run-sync": { "post": { "operationId": "run-sync-axiomworks-dhl-parcel-prices-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": { "startUrls": { "title": "DHL page objects, e.g. {\"url\":\"https://www.dhl.de/de/privatkunden.html\"}", "type": "array", "description": "Public DHL Germany page objects, e.g. [{\"url\":\"https://www.dhl.de/de/privatkunden.html\"}]. Omit for the domestic catalogue. Only HTTP(S) URLs on dhl.de or www.dhl.de are accepted. Overview pages follow linked price pages; unavailable targets are skipped, and if all are unavailable the run succeeds with zero offers. For destinationCountries, supply an international price page.", "default": [ { "url": "https://www.dhl.de/de/privatkunden.html" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Shared offer limit, e.g. 20", "minimum": 1, "maximum": 500, "type": "integer", "description": "Positive integer limiting matching offers across all startUrls, after filters and deduplication, e.g. 20. Default 50; 1-500 recommended. The homepage has 7 unique offers, so 20 returns 7 when unchanged. Results follow page order; this does not sort by price.", "default": 50 }, "includeRawText": { "title": "Include rawText, e.g. true", "type": "boolean", "description": "Set true to add rawText with visible product card or table-row text, e.g. {\"includeRawText\":true}. Default false omits rawText.", "default": false }, "categories": { "title": "Categories, e.g. [\"packet\",\"parcel\"]", "type": "array", "description": "Category strings to keep, e.g. [\"packet\"] or [\"parcel\",\"packet\"]. Accepted values: packet, parcel, letter; comparisons ignore case. Default [] keeps all. Combined with the other filters; unmatched values return no offers.", "default": [], "items": { "type": "string" } }, "destinationCountries": { "title": "Destination codes, e.g. [\"AUT\",\"FRA\"]", "type": "array", "description": "International destination codes from DHL order links, e.g. [\"AUT\",\"FRA\"]. Comparisons ignore case. Default [] keeps all. Requires an international price page in startUrls: domestic offers have no destinationCountry and do not match this filter.", "default": [], "items": { "type": "string" } }, "maxPriceEur": { "title": "Price ceiling in EUR, e.g. 10", "type": "number", "description": "Nonnegative numeric ceiling for priceEur, e.g. 10. Omit for no price ceiling. Combined with categories and destinationCountries; a ceiling below all published prices returns zero offers successfully. This filters published offer prices, not a shipment quote." }, "proxyConfiguration": { "title": "Proxy settings, e.g. {\"useApifyProxy\":false}", "type": "object", "description": "Proxy object, e.g. {\"useApifyProxy\":false} for direct requests (default). Configured proxies are used first. HTTP 403, 429, server errors or block pages retry with backoff on fresh sessions, escalating to Apify datacenter then residential Germany when available.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }