# Amazon BizTrend Keyword Scraper (`ib4ngz/amazon-biztrend-keyword-scraper`) Actor

Search Amazon by keyword across multiple marketplaces, collect and deduplicate product URLs from search-result pages, then extract structured product data with keyword, page, position, and region metadata.

- **URL**: https://apify.com/ib4ngz/amazon-biztrend-keyword-scraper.md
- **Developed by:** [Iqbal R](https://apify.com/ib4ngz) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Amazon BizTrend Keyword Scraper

Amazon BizTrend Keyword Scraper is an Apify Actor designed to discover and scrape Amazon products using search keywords across multiple Amazon marketplaces. Instead of requiring individual product URLs, the actor opens Amazon search result pages, collects product URLs from the requested number of pages, removes duplicate products, and extracts structured product data using the Amazon BizTrend product scraper.

It is built for developers, e-commerce businesses, market researchers, and data analysts who need keyword-level product data for product discovery, price monitoring, competitor research, market analysis, and trend analytics.

The actor supports a wide range of Amazon regions and automatically adapts to marketplace-specific capabilities. Where supported, it can configure the preferred delivery destination and currency before scraping, providing location-aware pricing and availability data while gracefully skipping unsupported features.

### Features

- Search Amazon products using one or more keywords.
- Scrape multiple search result pages for each keyword.
- Support multiple Amazon marketplaces through region selection.
- Extract product URLs and ASINs from Amazon search results.
- Remove duplicate ASINs before adding product requests.
- Record the keyword, search page, and product position.
- Automatically set the preferred currency where supported.
- Automatically set the preferred delivery country where supported.
- Extract product pricing and availability information.
- Detect product delivery restrictions.
- Extract seller information.
- Extract product rating and review count.
- Return consistent structured JSON output.
- Designed for product discovery, historical tracking, and analytics.

### Compatibility

Amazon marketplaces provide different customer preference options. Some marketplaces support changing the delivery destination and/or currency, while others do not.

When a feature is not supported by the selected marketplace, the actor automatically skips that step and continues collecting available product data.

| Domain | Deliver To Country | Currency |
|-------------|:------------------:|:--------:|
| Amazon.com | ✅ | ✅ |
| Amazon.com.au | ✅ | ✅ |
| Amazon.ae | ✅ | ✅ |
| Amazon.co.uk | ✅ | ✅ |
| Amazon.de | ✅ | ✅ |
| Amazon.es | ✅ | ✅ |
| Amazon.fr | ✅ | ✅ |
| Amazon.it | ✅ | ✅ |
| Amazon.co.jp | ✅ | ✅ |
| Amazon.nl | ✅ | ❌ |
| Amazon.sg | ✅ | ✅ |
| Amazon.be | ❌ | ❌ |
| Amazon.br | ❌ | ❌ |
| Amazon.ca | ❌ | ❌ |
| Amazon.eg | ❌ | ❌ |
| Amazon.in | ❌ | ❌ |
| Amazon.ie | ❌ | ❌ |
| Amazon.com.mx | ❌ | ❌ |
| Amazon.pl | ❌ | ❌ |
| Amazon.sa | ❌ | ❌ |
| Amazon.co.za | ❌ | ❌ |
| Amazon.se | ❌ | ❌ |
| Amazon.com.tr | ❌ | ❌ |

> **Note**
>
> - ✅ Supported by the marketplace.
> - ❌ Not supported by the marketplace.
> - Marketplace capabilities are based on manual testing and may change as Amazon updates its regional websites.
> - Amazon.cn is excluded.

### Input Schema

| Field | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| `keywords` | Array | Yes | - | One or more product search keywords, such as `wireless mouse` or `men's hoodie`. |
| `maxPages` | Integer | No | `1` | Maximum number of Amazon search result pages to process for each keyword. |
| `region` | String | No | `United States` | Amazon marketplace used for product searches. |
| `currencyId` | String | No | `USD` | Currency code used when scraping products, such as USD, EUR, GBP, JPY, or MYR. |
| `deliverTo` | String | No | `Australia` | Delivery destination used to determine location-aware pricing and availability. |
| `timeout` | Integer | No | `10000` | Navigation and element waiting timeout in milliseconds. |
| `maxRequestRetries` | Integer | No | `5` | Maximum retry attempts for failed search or product requests. |
| `proxyConfiguration` | Object | No | Apify Proxy | Proxy configuration used for requests. Supports Apify Proxy or custom proxy servers to improve reliability and reduce the risk of request blocking. |

### Dataset Schema

Each dataset item contains search metadata together with the scraped product data:

| Field | Type | Description |
|-------|------|-------------|
| `keyword` | String | Keyword used to discover the product. |
| `page` | Integer | Search result page where the product was found. |
| `position` | Integer | Product position on the search result page. |
| `region` | String | Amazon marketplace region used for the search. |
| `asin` | String | Amazon Standard Identification Number. |
| `url` | String | Canonical Amazon product URL. |
| `title` | String | Product title. |
| `currencyCode` | String | Currency code detected on the product page. |
| `currencySymbol` | String | Currency symbol displayed on Amazon. |
| `price` | Number | Product price. |
| `deliverToCountry` | String | Delivery country detected on the product page. |
| `availability` | String | Product availability message returned by Amazon. |
| `seller` | String | Product seller. |
| `rating` | Number | Average customer rating. |
| `reviewCount` | Integer | Number of customer reviews. |
| `hasDeliveryError` | Boolean | Indicates whether the product cannot be delivered to the selected destination. |
| `deliveryErrorText` | String | Delivery restriction message returned by Amazon. |
| `currencyUpdated` | Boolean | Indicates whether the currency preference was updated. |
| `deliverToUpdated` | Boolean | Indicates whether the delivery country was updated. |
| `deliverToSkipped` | Boolean | Indicates whether the delivery country update was skipped because it was already set correctly. |
| `scrapedAt` | String | ISO 8601 timestamp indicating when the product was scraped. |

### How to Use

1. Open the actor on Apify.
2. Add one or more product search terms to **keywords**.
3. Set **maxPages** to control how many search result pages are processed for each keyword.
4. Select the desired Amazon **region**.
5. Select the preferred **currencyId** and **deliverTo** country.
6. Configure a proxy if needed.
7. Run the actor and wait for the run to finish.
8. Export the dataset as JSON, CSV, Excel, or integrate it using the Apify API.

### Search Results and Deduplication

The actor extracts products from Amazon search result cards using their ASINs. Duplicate ASINs found across pages for the same keyword are removed before product requests are added.

The `position` field represents the product's original position on its search result page. Sponsored products may be included when Amazon exposes them as standard search result cards with a valid ASIN.

The collected data can be used for:

- Amazon keyword product research
- Product and niche discovery
- Competitor product monitoring
- Search result position analysis
- Price and availability monitoring
- Seller comparison
- Historical product tracking
- Market research
- Business intelligence dashboards
- Custom analytics pipelines

### Important Notes

- Amazon search results can vary based on region, delivery destination, currency, proxy location, cookies, and time of collection.
- The number of products returned may differ between pages because Amazon can include widgets, placeholders, duplicate products, or cards without a valid ASIN.
- `maxPages` is applied separately to every keyword.
- Duplicate removal is performed during the current actor run. A new run may scrape the same ASIN again, which is useful for tracking price and availability changes over time.
- Amazon may change its page structure or marketplace capabilities without notice.

### Conclusion

Amazon BizTrend Keyword Scraper combines keyword-based product discovery with detailed Amazon product scraping. It provides structured search metadata and location-aware product information, making it a strong foundation for product research, competitor monitoring, pricing analysis, and e-commerce trend intelligence.

# Actor input Schema

## `keywords` (type: `array`):

Keywords to search for on Amazon.
## `maxPages` (type: `integer`):

Maximum number of Amazon search-result pages to process per keyword.
## `region` (type: `string`):

Amazon marketplace used for keyword searches.
## `currencyId` (type: `string`):

Select Amazon display currency.
## `deliverTo` (type: `string`):

Amazon Deliver To country selection.
## `timeout` (type: `integer`):

Timeout in milliseconds for page navigation and selector waits.
## `maxRequestRetries` (type: `integer`):

Maximum retry attempts for each failed URL.
## `proxyConfiguration` (type: `object`):

Proxy configuration used for crawling.

## Actor input object example

```json
{
  "keywords": [
    "wireless mouse",
    "gaming keyboard",
    "desk organizer"
  ],
  "maxPages": 1,
  "region": "United States",
  "currencyId": "USD",
  "deliverTo": "Australia",
  "timeout": 10000,
  "maxRequestRetries": 5
}
````

# Actor output Schema

## `results` (type: `string`):

No description

## `dataset` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "wireless mouse",
        "gaming keyboard",
        "desk organizer"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("ib4ngz/amazon-biztrend-keyword-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": [
        "wireless mouse",
        "gaming keyboard",
        "desk organizer",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("ib4ngz/amazon-biztrend-keyword-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 '{
  "keywords": [
    "wireless mouse",
    "gaming keyboard",
    "desk organizer"
  ]
}' |
apify call ib4ngz/amazon-biztrend-keyword-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=ib4ngz/amazon-biztrend-keyword-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Amazon BizTrend Keyword Scraper",
        "description": "Search Amazon by keyword across multiple marketplaces, collect and deduplicate product URLs from search-result pages, then extract structured product data with keyword, page, position, and region metadata.",
        "version": "1.0",
        "x-build-id": "9RvUFxPYqKFCPd9lN"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/ib4ngz~amazon-biztrend-keyword-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-ib4ngz-amazon-biztrend-keyword-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/ib4ngz~amazon-biztrend-keyword-scraper/runs": {
            "post": {
                "operationId": "runs-sync-ib4ngz-amazon-biztrend-keyword-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/ib4ngz~amazon-biztrend-keyword-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-ib4ngz-amazon-biztrend-keyword-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",
                "required": [
                    "keywords",
                    "maxPages",
                    "region"
                ],
                "properties": {
                    "keywords": {
                        "title": "Search Keywords",
                        "minItems": 1,
                        "type": "array",
                        "description": "Keywords to search for on Amazon.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxPages": {
                        "title": "Maximum Search Pages",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Maximum number of Amazon search-result pages to process per keyword.",
                        "default": 1
                    },
                    "region": {
                        "title": "Amazon Region",
                        "enum": [
                            "Australia",
                            "Belgium",
                            "Brazil",
                            "Canada",
                            "Egypt",
                            "France",
                            "Germany",
                            "India",
                            "Ireland",
                            "Italy",
                            "Japan",
                            "Mexico",
                            "Netherlands",
                            "Poland",
                            "Saudi Arabia",
                            "Singapore",
                            "South Africa",
                            "Spain",
                            "Sweden",
                            "Turkey",
                            "United Arab Emirates",
                            "United Kingdom",
                            "United States"
                        ],
                        "type": "string",
                        "description": "Amazon marketplace used for keyword searches.",
                        "default": "United States"
                    },
                    "currencyId": {
                        "title": "Currency",
                        "enum": [
                            "USD",
                            "CLP",
                            "COP",
                            "HKD",
                            "IDR",
                            "ILS",
                            "KRW",
                            "MYR",
                            "NZD",
                            "THB",
                            "TWD",
                            "CRC",
                            "PEN",
                            "UYU",
                            "BRL",
                            "AUD",
                            "CAD",
                            "CNY",
                            "EUR",
                            "JPY",
                            "MXN",
                            "GBP",
                            "AED",
                            "SGD",
                            "SAR",
                            "NOK",
                            "ARS",
                            "AMD",
                            "AWG",
                            "AZN",
                            "BSD",
                            "BZD",
                            "BOB",
                            "BND",
                            "BGN",
                            "KHR",
                            "KYD",
                            "DOP",
                            "XCD",
                            "EGP",
                            "GHS",
                            "GTQ",
                            "HUF",
                            "INR",
                            "JMD",
                            "KZT",
                            "KES",
                            "LBP",
                            "HNL",
                            "MOP",
                            "MUR",
                            "MAD",
                            "NAD",
                            "NGN",
                            "PAB",
                            "PYG",
                            "QAR",
                            "RUB",
                            "ZAR",
                            "TZS",
                            "PHP",
                            "TTD",
                            "MNT",
                            "TRY",
                            "VND",
                            "SEK",
                            "PLN",
                            "BBD",
                            "BMD",
                            "XPF",
                            "XOF",
                            "XAF",
                            "NIO",
                            "CZK",
                            "DKK",
                            "GEL",
                            "GYD",
                            "PKR",
                            "RON",
                            "MVR",
                            "LKR",
                            "CHF",
                            "UZS"
                        ],
                        "type": "string",
                        "description": "Select Amazon display currency.",
                        "default": "USD"
                    },
                    "deliverTo": {
                        "title": "Deliver To Country",
                        "enum": [
                            "Australia",
                            "Canada",
                            "China",
                            "Japan",
                            "Mexico",
                            "Singapore",
                            "United Kingdom",
                            "Afghanistan",
                            "Aland Islands",
                            "Albania",
                            "Algeria",
                            "American Samoa",
                            "Andorra",
                            "Angola",
                            "Anguilla",
                            "Antigua and Barbuda",
                            "Argentina",
                            "Armenia",
                            "Aruba",
                            "Austria",
                            "Azerbaijan",
                            "Bahamas, The",
                            "Bahrain",
                            "Bangladesh",
                            "Barbados",
                            "Belarus",
                            "Belgium",
                            "Belize",
                            "Benin",
                            "Bermuda",
                            "Bhutan",
                            "Bolivia",
                            "Bonaire, Saint Eustatius and Saba",
                            "Bosnia and Herzegovina",
                            "Botswana",
                            "Bouvet Island",
                            "Brazil",
                            "British Indian Ocean Territory",
                            "Brunei Darussalam",
                            "Bulgaria",
                            "Burkina Faso",
                            "Burundi",
                            "Cambodia",
                            "Cameroon",
                            "Cape Verde",
                            "Cayman Islands",
                            "Central African Republic",
                            "Chad",
                            "Chile",
                            "Christmas Island",
                            "Cocos (Keeling) Islands",
                            "Colombia",
                            "Comoros",
                            "Congo",
                            "Congo, The Democratic Republic of the",
                            "Cook Islands",
                            "Costa Rica",
                            "Cote D'ivoire",
                            "Croatia",
                            "Curaçao",
                            "Cyprus",
                            "Czech Republic",
                            "Denmark",
                            "Djibouti",
                            "Dominica",
                            "Dominican Republic",
                            "Ecuador",
                            "Egypt",
                            "El Salvador",
                            "Equatorial Guinea",
                            "Eritrea",
                            "Estonia",
                            "Ethiopia",
                            "Falkland Islands (Malvinas)",
                            "Faroe Islands",
                            "Fiji",
                            "Finland",
                            "France",
                            "French Guiana",
                            "French Polynesia",
                            "French Southern Territories",
                            "Gabon",
                            "Gambia, The",
                            "Georgia",
                            "Germany",
                            "Ghana",
                            "Gibraltar",
                            "Greece",
                            "Greenland",
                            "Grenada",
                            "Guadeloupe",
                            "Guatemala",
                            "Guernsey",
                            "Guinea",
                            "Guinea-Bissau",
                            "Guyana",
                            "Haiti",
                            "Heard Island and the McDonald Islands",
                            "Holy See",
                            "Honduras",
                            "Hong Kong",
                            "Hungary",
                            "Iceland",
                            "India",
                            "Indonesia",
                            "Iraq",
                            "Ireland",
                            "Isle of Man",
                            "Israel",
                            "Italy",
                            "Jamaica",
                            "Jersey",
                            "Jordan",
                            "Kazakhstan",
                            "Kenya",
                            "Kiribati",
                            "Kosovo",
                            "Kuwait",
                            "Kyrgyzstan",
                            "Lao People's Democratic Republic",
                            "Latvia",
                            "Lebanon",
                            "Lesotho",
                            "Liberia",
                            "Libya",
                            "Liechtenstein",
                            "Lithuania",
                            "Luxembourg",
                            "Macao",
                            "Macedonia, The Former Yugoslav Republic of",
                            "Madagascar",
                            "Malawi",
                            "Malaysia",
                            "Maldives",
                            "Mali",
                            "Malta",
                            "Marshall Islands",
                            "Martinique",
                            "Mauritania",
                            "Mauritius",
                            "Mayotte",
                            "Micronesia, Federated States of",
                            "Moldova, Republic of",
                            "Monaco",
                            "Mongolia",
                            "Montenegro",
                            "Montserrat",
                            "Morocco",
                            "Mozambique",
                            "Myanmar",
                            "Namibia",
                            "Nauru",
                            "Nepal",
                            "Netherlands",
                            "Netherlands Antilles",
                            "New Caledonia",
                            "New Zealand",
                            "Nicaragua",
                            "Niger",
                            "Nigeria",
                            "Niue",
                            "Norfolk Island",
                            "Norway",
                            "Oman",
                            "Pakistan",
                            "Palau",
                            "Palestinian Territories",
                            "Panama",
                            "Papua New Guinea",
                            "Paraguay",
                            "Peru",
                            "Philippines",
                            "Pitcairn",
                            "Poland",
                            "Portugal",
                            "Qatar",
                            "Republic of Korea",
                            "Reunion",
                            "Romania",
                            "Russian Federation",
                            "Rwanda",
                            "Saint Barthelemy",
                            "Saint Helena, Ascension and Tristan da Cunha",
                            "Saint Kitts and Nevis",
                            "Saint Lucia",
                            "Saint Martin",
                            "Saint Pierre and Miquelon",
                            "Saint Vincent and the Grenadines",
                            "Samoa",
                            "San Marino",
                            "Sao Tome and Principe",
                            "Saudi Arabia",
                            "Senegal",
                            "Serbia",
                            "Seychelles",
                            "Sierra Leone",
                            "Sint Maarten",
                            "Slovakia",
                            "Slovenia",
                            "Solomon Islands",
                            "Somalia",
                            "South Africa",
                            "South Georgia and the South Sandwich Islands",
                            "Spain",
                            "Sri Lanka",
                            "Suriname",
                            "Svalbard and Jan Mayen",
                            "Swaziland",
                            "Sweden",
                            "Switzerland",
                            "Taiwan",
                            "Tajikistan",
                            "Tanzania, United Republic of",
                            "Thailand",
                            "Timor-leste",
                            "Togo",
                            "Tokelau",
                            "Tonga",
                            "Trinidad and Tobago",
                            "Tunisia",
                            "Turkey",
                            "Turkmenistan",
                            "Turks and Caicos Islands",
                            "Tuvalu",
                            "Uganda",
                            "Ukraine",
                            "United Arab Emirates",
                            "United States Minor Outlying Islands",
                            "Uruguay",
                            "Uzbekistan",
                            "Vanuatu",
                            "Venezuela",
                            "Vietnam",
                            "Virgin Islands, British",
                            "Wallis and Futuna",
                            "Western Sahara",
                            "Yemen",
                            "Zambia",
                            "Zimbabwe"
                        ],
                        "type": "string",
                        "description": "Amazon Deliver To country selection.",
                        "default": "Australia"
                    },
                    "timeout": {
                        "title": "Timeout",
                        "minimum": 5000,
                        "maximum": 180000,
                        "type": "integer",
                        "description": "Timeout in milliseconds for page navigation and selector waits.",
                        "default": 10000
                    },
                    "maxRequestRetries": {
                        "title": "Max Request Retries",
                        "minimum": 3,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Maximum retry attempts for each failed URL.",
                        "default": 5
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy configuration used for crawling."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
