# BYD Pricing Monitor Scraper (`rastriq/byd-pricing-monitor-scraper`) Actor
Extracts BYD Europe country, dealer, catalog, prices and finance data for different countries.
- **URL**: https://apify.com/rastriq/byd-pricing-monitor-scraper.md
- **Developed by:** [Rastriq โ Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $5.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## BYD Global Catalog Scraper
Extract official BYD vehicle prices, trim levels, and dealer locations across **19 countries** โ pulled directly from BYD's own CMS in seconds.
Track prices, model availability, and the dealer network across Europe, Latin America, and Africa without manual research.
---
### What does it extract?
| Data | Details |
|---|---|
| ๐ **Vehicle prices** | List price with VAT per trim level and market |
| ๐ **Trim levels** | All equipment versions (Comfort, Design, Excellenceโฆ) |
| ๐จ **Configuration options** | Colors, interior choices, and wheel sizes per variant |
| โก **Key specs** | Range, acceleration, and selling highlights per trim |
| ๐ **Dealer locations** | Official BYD dealer network by country (Europe only) |
| ๐ **Financing products** | Renting and leasing terms (Europe only) |
---
### Market coverage
#### ๐ช๐บ Europe โ prices in local currency
Belgium ยท Bulgaria ยท Croatia ยท Czech Republic ยท Finland ยท France ยท Germany ยท Hungary ยท Italy ยท Netherlands ยท Poland ยท Romania ยท Slovakia ยท Slovenia ยท Spain ยท Switzerland
**17 verified models** with official prices in EUR, HUF, PLN, CZK, and CHF โ including BYD Seal, Sealion 7, Dolphin, Dolphin Surf, Atto 2, Atto 3, Seal U, Seal 6 DM-i, Han, and Tang.
Dealer locations and financing products available for all European markets.
> Note: Croatia (HR) shares BYD's Czech CMS endpoint โ prices are in CZK and reflect the Czech market configuration.
#### ๐ Middle East & Africa
**South Africa** โ 10 models with real ZAR prices: Atto 2 DM-i, Atto 3, Atto 8, Dolphin, Dolphin Surf, Seal, Sealion 5 DM-i, Sealion 6 DM-i, Sealion 7, Shark 6 DMO.
**Kuwait & Qatar** โ Full catalog structure available. BYD has not yet published list prices in its CMS for these markets.
#### ๐ Latin America
Full catalog and trim data via BYD's shared Spanish-language endpoint. Prices are set at dealer level and are not published centrally by BYD.
---
### How to use
**1. Choose a region**
Select Europe, Latin America, or Middle East & Africa.
**2. Pick your markets** *(optional)*
Select one or more countries โ or leave blank to cover the entire region.
**3. Select models** *(optional)*
โญ **Leave blank to extract the full catalog** โ the recommended approach. The scraper automatically uses the verified model pool for each country.
Select specific models only when you need a quick test or want to monitor a single vehicle.
**4. Configure data types**
Toggle vehicle prices, dealer locations, and financing products on or off.
**5. Run and export**
Hit Start. Download results as JSON, CSV, or Excel, or connect to Google Sheets.
---
### Input parameters
| Parameter | Default | Description |
|---|---|---|
| **Region** | Europe | Europe, Latin America, or Middle East & Africa |
| **Countries** | Spain | One or more markets. Empty = entire region |
| **Models** | *(empty)* | Specific models to extract. **Empty = full catalog per country** |
| **Variants & prices** | On | Prices, trim levels, and configuration options |
| **Dealer locations** | On | Official BYD dealer network (Europe only) |
| **Financing products** | Off | Renting and leasing terms (Europe only) |
---
### Output
Each run produces up to four record types in a single flat dataset, distinguished by `record_type`:
| Record type | Content |
|---|---|
| `vehicle_variant` | One row per trim level per market โ price, currency, specs, SKU list |
| `dealer` | One row per official BYD dealer location |
| `finance_agreement` | Renting / leasing product with duration, mileage, and services |
| `country` | Market metadata (enabled only if `includeCountries` is set) |
#### Example record
```json
{
"record_type": "vehicle_variant",
"country_code": "DE",
"country_name": "Germany",
"language_locale": "de",
"model_code": "CX009017",
"product_code": "KX009017146",
"series_code": "BYD009",
"price": 47990,
"currency": "EUR",
"shared_cms_locale": false,
"scraped_at": "2026-07-11T20:00:00Z",
"raw": {
"model_name_en": "BYD SEAL 2026",
"product_name_alias": "Comfort",
"formatted_price": "47.990 โฌ",
"vat": 19,
"sales_topics": ["Up to 460 km range (WLTP)", "15.6\" rotating touchscreen"],
"specification": { "colors": { "list": [...] }, "interior": { "list": [...] } },
"sku_list": [...]
}
}
````
#### `shared_cms_locale` field
When `true`, BYD's CMS serves this country via a shared locale endpoint used by another market. The prices and specs reflect that shared market's configuration, not a dedicated local one. Currently affects:
- `HR` (Croatia) โ served via the Czech (`cz`) endpoint; prices in CZK
- `BE` (Belgium) โ served via `nl` and `fr` endpoints shared with Netherlands and France
- `CH` (Switzerland) โ has dedicated `de-ch`, `fr-ch`, and `it-ch` endpoints in CHF
***
### Pricing
The BYD Global Catalog Scraper uses Apify's standard Compute Unit pricing.
| Scope | Records | Estimated cost |
|---|---|---|
| 1 country ยท 1 model | ~3โ10 | < $0.01 |
| 1 country ยท all models | ~30โ60 | < $0.05 |
| All Europe ยท all models | ~500โ600 | < $0.20 |
| All regions ยท all models | ~600โ700 | < $0.25 |
***
### FAQ
**Which BYD models are included?**
All models with an active CMS catalog endpoint, verified by market. The pool is maintained per region and per country โ Europe has 17 models, South Africa 10, Kuwait 3, and Qatar 6. The full catalog is extracted automatically when no models are specified.
**Why are there no prices for Latin America?**
BYD sets prices at dealer level in Latin American markets rather than publishing them centrally. The scraper returns full model structure, trim levels, and equipment โ without a list price.
**Why are Kuwait and Qatar prices zero?**
BYD has configured its CMS for these markets and the catalog structure is present, but list prices have not been published yet. The scraper returns all available data; prices will appear automatically once BYD publishes them.
**How do I monitor price changes over time?**
Use Apify's scheduler to run the scraper daily or weekly. Each run captures a full price snapshot. Compare datasets over time to detect price movements, new trim additions, or model launches.
**Can I get a specific model across all markets?**
Yes โ select the model (e.g. BYD Seal) and leave Countries blank. The scraper will return pricing and availability for that model across all active markets in the selected region.
**How fresh is the data?**
Every run pulls live data from BYD's CMS at execution time. There is no caching โ results always reflect the current catalog.
# Actor input Schema
## `region` (type: `string`):
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)
## `countries` (type: `array`):
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.
## `models` (type: `array`):
โญ 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.
## `includeVariants` (type: `boolean`):
Extract all trim variants per model: equipment levels, colors, wheel options, and price where available.
## `includeDealers` (type: `boolean`):
Extract the official BYD dealer network for each selected country.
โ ๏ธ Available in Europe only.
## `includeFinancing` (type: `boolean`):
Extract available renting and financing products with terms and conditions.
โ ๏ธ Available in selected European markets only.
## `requestDelayMs` (type: `integer`):
Wait time between requests to BYD servers.
Increase to 500+ if you encounter frequent connection errors.
## `maxRetries` (type: `integer`):
Number of retry attempts on transient network or server errors.
## `proxyConfiguration` (type: `object`):
BYD's catalog endpoints are publicly accessible. Proxy is not required under normal conditions.
## Actor input object example
```json
{
"region": "europe",
"countries": [
"ES"
],
"models": [],
"includeVariants": true,
"includeDealers": true,
"includeFinancing": false,
"requestDelayMs": 100,
"maxRetries": 2,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `results` (type: `string`):
All extracted records as a flat dataset. Use the record\_type field to split into countries, dealers, vehicle\_variants, and finance\_agreements.
## `summary` (type: `string`):
Run summary: total record count and breakdown by record\_type (country, dealer, vehicle\_variant, finance\_agreement).
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"region": "europe",
"countries": [
"ES"
],
"models": [],
"includeVariants": true,
"includeDealers": false,
"includeFinancing": false,
"requestDelayMs": 100,
"maxRetries": 2,
"proxyConfiguration": {
"useApifyProxy": false
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/byd-pricing-monitor-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`๐พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"region": "europe",
"countries": ["ES"],
"models": [],
"includeVariants": True,
"includeDealers": False,
"includeFinancing": False,
"requestDelayMs": 100,
"maxRetries": 2,
"proxyConfiguration": { "useApifyProxy": False },
}
# Run the Actor and wait for it to finish
run = client.actor("rastriq/byd-pricing-monitor-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("๐พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"region": "europe",
"countries": [
"ES"
],
"models": [],
"includeVariants": true,
"includeDealers": false,
"includeFinancing": false,
"requestDelayMs": 100,
"maxRetries": 2,
"proxyConfiguration": {
"useApifyProxy": false
}
}' |
apify call rastriq/byd-pricing-monitor-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=rastriq/byd-pricing-monitor-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"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
}
}
}
}
}
}
}
}
}
}
```