{ "openapi": "3.0.1", "info": { "title": "BYD Pricing Monitor Scraper", "description": "Extracts BYD Europe country, dealer, catalog, prices and finance data for different countries.", "version": "0.1", "x-build-id": "HmF8lpBljUbr3VPvm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rastriq~byd-pricing-monitor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rastriq-byd-pricing-monitor-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/rastriq~byd-pricing-monitor-scraper/runs": { "post": { "operationId": "runs-sync-rastriq-byd-pricing-monitor-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/rastriq~byd-pricing-monitor-scraper/run-sync": { "post": { "operationId": "run-sync-rastriq-byd-pricing-monitor-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": { "region": { "title": "🌍 Region", "enum": [ "europe", "latam", "mea" ], "type": "string", "description": "Select the region you want to extract data from.

â€ĸ Europe — 16 countries with prices, dealers, and financing
â€ĸ Latin America — catalog and trim data (prices set at dealer level, not published centrally)
â€ĸ Middle East & Africa — Kuwait, Qatar, and South Africa (ZAR prices available for ZA)", "default": "europe" }, "countries": { "title": "📍 Countries", "type": "array", "description": "Filter by specific countries within the selected region.
Leave blank to process all available countries automatically.

ℹī¸ Only countries where BYD has an active catalog are listed.", "items": { "type": "string", "enum": [ "BE", "BG", "HR", "CZ", "FI", "FR", "DE", "HU", "IT", "NL", "PL", "RO", "SK", "SI", "ES", "CH", "AR", "BO", "BR", "BS", "CL", "CO", "CR", "DO", "EC", "GT", "MX", "PA", "PE", "SV", "UY", "KW", "QA", "ZA" ], "enumTitles": [ "🇧đŸ‡Ē Belgium", "🇧đŸ‡Ŧ Bulgaria", "🇭🇷 Croatia", "🇨đŸ‡ŋ Czech Republic", "đŸ‡Ģ🇮 Finland", "đŸ‡Ģ🇷 France", "🇩đŸ‡Ē Germany", "🇭đŸ‡ē Hungary", "🇮🇹 Italy", "đŸ‡ŗ🇱 Netherlands", "đŸ‡ĩ🇱 Poland", "🇷🇴 Romania", "🇸🇰 Slovakia", "🇸🇮 Slovenia", "đŸ‡Ē🇸 Spain", "🇨🇭 Switzerland", "đŸ‡Ļ🇷 Argentina", "🇧🇴 Bolivia", "🇧🇷 Brazil", "🇧🇸 Bahamas", "🇨🇱 Chile", "🇨🇴 Colombia", "🇨🇷 Costa Rica", "🇩🇴 Dominican Republic", "đŸ‡Ē🇨 Ecuador", "đŸ‡Ŧ🇹 Guatemala", "🇲đŸ‡Ŋ Mexico", "đŸ‡ĩđŸ‡Ļ Panama", "đŸ‡ĩđŸ‡Ē Peru", "🇸đŸ‡ģ El Salvador", "đŸ‡ē🇾 Uruguay", "🇰đŸ‡ŧ Kuwait", "đŸ‡ļđŸ‡Ļ Qatar", "đŸ‡ŋđŸ‡Ļ South Africa" ] }, "default": [ "ES" ] }, "models": { "title": "🚗 Models", "type": "array", "description": "⭐ Leave blank to extract the full catalog — this is the recommended way to get all available models per country, automatically assigned by market.

Use this filter only when you need a specific model (e.g. quick test, single-model price monitoring).

ℹī¸ Not all models are available in all markets. Model pools are maintained per region and per country.", "items": { "type": "string", "enum": [ "CX009017", "CX012026", "CX017035", "CX013030", "CX025001", "CX004031", "CX008033", "CX007011", "CX022058", "CX023060", "CX005005", "CX006007", "CX009015", "CX004021", "CX004003", "CX008013", "CX007009", "CX002051", "CX005052", "CX013072", "CX025102", "CX026109", "CX027154", "CX007073", "CX014074", "CX015144", "CX004053", "CX002060", "CX008057", "CX006047", "CX002044", "CX005010", "CX005038", "CX005090", "CX014091", "CX017028", "CX013016", "CX016022", "CX002002", "CX003003", "CX004036", "CX004006", "CX005004", "CX005019", "CX006024", "CX006005", "CX006039", "CX007007", "CX005021", "CX005012", "CX002013", "CX005023", "CX015018", "CX004034" ], "enumTitles": [ "đŸ‡ĒđŸ‡ē BYD Seal 2026 — electric sedan (from â‚Ŧ41,990)", "đŸ‡ĒđŸ‡ē BYD Sealion 7 — electric SUV (from â‚Ŧ47,990)", "đŸ‡ĒđŸ‡ē BYD Dolphin Surf — urban EV (from â‚Ŧ19,990)", "đŸ‡ĒđŸ‡ē BYD Atto 2 — compact electric SUV (from â‚Ŧ29,990)", "đŸ‡ĒđŸ‡ē BYD Atto 2 DM-i — compact plug-in hybrid SUV (from â‚Ŧ28,200)", "đŸ‡ĒđŸ‡ē BYD Atto 3 EVO — electric SUV (from â‚Ŧ38,990)", "đŸ‡ĒđŸ‡ē BYD Dolphin 2025 — compact EV (from â‚Ŧ36,690)", "đŸ‡ĒđŸ‡ē BYD Seal U — electric SUV (from â‚Ŧ38,500)", "đŸ‡ĒđŸ‡ē BYD Seal 6 DM-i — plug-in hybrid SUV (from â‚Ŧ37,000)", "đŸ‡ĒđŸ‡ē BYD Seal 6 DM-i Touring — plug-in hybrid estate (from â‚Ŧ38,500)", "đŸ‡ĒđŸ‡ē BYD Han — luxury electric sedan (from â‚Ŧ69,990)", "đŸ‡ĒđŸ‡ē BYD Tang — large electric SUV (from â‚Ŧ67,400)", "đŸ‡ĒđŸ‡ē BYD Seal (previous gen)", "đŸ‡ĒđŸ‡ē BYD Atto 3 2025 (current gen)", "đŸ‡ĒđŸ‡ē BYD Atto 3 (previous gen)", "đŸ‡ĒđŸ‡ē BYD Dolphin (previous gen)", "đŸ‡ĒđŸ‡ē BYD Seal U (previous gen)", "đŸ‡ŋđŸ‡Ļ South Africa BYD Atto 3 — ZAR 699,900", "đŸ‡ŋđŸ‡Ļ South Africa BYD Seal EV — ZAR 1,211,900", "đŸ‡ŋđŸ‡Ļ South Africa BYD Sealion 7 EV — ZAR 1,319,900", "đŸ‡ŋđŸ‡Ļ South Africa BYD Sealion 5 DM-i — ZAR 509,900", "đŸ‡ŋđŸ‡Ļ South Africa BYD Dolphin Surf — ZAR 395,900", "đŸ‡ŋđŸ‡Ļ South Africa BYD Atto 8 — ZAR 1,059,900", "đŸ‡ŋđŸ‡Ļ South Africa BYD Sealion 6 DM-i — ZAR 639,900", "đŸ‡ŋđŸ‡Ļ South Africa BYD Shark 6 DMO — ZAR 989,900", "đŸ‡ŋđŸ‡Ļ South Africa BYD Atto 2 DM-i — ZAR 449,900", "đŸ‡ŋđŸ‡Ļ South Africa BYD Dolphin — USD 539,900", "🇰đŸ‡ŧ Kuwait BYD Atto 3", "🇰đŸ‡ŧ Kuwait BYD Han", "🇰đŸ‡ŧđŸ‡ļđŸ‡Ļ Kuwait / Qatar BYD Qin Plus DM-i", "đŸ‡ļđŸ‡Ļ Qatar BYD Atto 3", "đŸ‡ļđŸ‡Ļ Qatar BYD Seal (RWD)", "đŸ‡ļđŸ‡Ļ Qatar BYD Seal (AWD)", "đŸ‡ļđŸ‡Ļ Qatar BYD Seal 7 DM-i", "đŸ‡ļđŸ‡Ļ Qatar BYD Shark 6", "🌎 Latin America BYD Sealion 7 EV", "🌎 Latin America BYD Seagull / Dolphin Mini", "🌎 Latin America BYD Shark", "🌎 Latin America BYD Dolphin", "🌎 Latin America BYD Han EV", "🌎 Latin America BYD Atto 8 / Tang", "🌎 Latin America BYD Tang EV", "🌎 Latin America BYD Song Plus DM-i", "🌎 Latin America BYD Song Pro DM-i", "🌎 Latin America BYD Yuan Pro / Up", "🌎 Latin America BYD Yuan Plus", "🌎 Latin America BYD Yuan Pro DM-i", "🌎 Latin America BYD Seal EV", "🌎 Latin America BYD Song Plus EV", "đŸ‡Ļ🇷 Argentina BYD Song", "🇧🇷 Brazil BYD Dolphin", "🇧🇷 Brazil BYD Song", "🇲đŸ‡Ŋ🇧🇷 Mexico / Brazil BYD King / Denza", "🇲đŸ‡Ŋ Mexico BYD M9" ] }, "default": [] }, "includeVariants": { "title": "💰 Variants & prices", "type": "boolean", "description": "Extract all trim variants per model: equipment levels, colors, wheel options, and price where available.", "default": true }, "includeDealers": { "title": "📍 Dealer locations", "type": "boolean", "description": "Extract the official BYD dealer network for each selected country.

⚠ī¸ Available in Europe only.", "default": true }, "includeFinancing": { "title": "📄 Financing & leasing", "type": "boolean", "description": "Extract available renting and financing products with terms and conditions.

⚠ī¸ Available in selected European markets only.", "default": false }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Wait time between requests to BYD servers.
Increase to 500+ if you encounter frequent connection errors.", "default": 250 }, "maxRetries": { "title": "Max retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of retry attempts on transient network or server errors.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "BYD's catalog endpoints are publicly accessible. Proxy is not required under normal conditions.", "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 } } }, "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 } } } } } } } } } }