# Huutokaupat Product Search Scraper (`stealth_mode/huutokaupat-product-search-scraper`) Actor

Scrape product listings from Huutokaupat.com search results instantly. Collect auction titles, pricing, bidding history, seller info, locations, and 60+ fields per item — perfect for market analysis, competitive intelligence, and inventory aggregation.

- **URL**: https://apify.com/stealth\_mode/huutokaupat-product-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

## Huutokaupat Product Search Scraper: Extract Auction Data at Scale

---

### What Is Huutokaupat?

Huutokaupat.com is Finland's largest online auction marketplace, hosting thousands of daily listings across categories like vehicles, electronics, collectibles, and real estate. Whether you're tracking market prices, analyzing competitor inventory, or researching buying trends, manually extracting this data is impractical. The **Huutokaupat Product Search Scraper** automates the extraction, turning auction listings into clean, queryable datasets.

---

### Overview

The **Huutokaupat Product Search Scraper** extracts auction items from search results pages, capturing comprehensive product metadata including auction status, bidding details, seller information, and location data. It is ideal for:

- **Price researchers** tracking market values across product categories
- **Resellers & dealers** monitoring competitor listings and inventory
- **Market analysts** studying auction trends and demand patterns
- **Data aggregators** building multi-source product databases
- **Business intelligence** teams feeding data into analytics platforms

Key strengths include high item limits per search page (up to 200), robust error handling with `ignore_url_failures`, and detailed auction metadata covering pricing, bids, and bidder statistics.

---

### Input Format

The scraper accepts a JSON configuration object for flexible search-based extraction:

```json
{
  "urls": [
    "https://huutokaupat.com/en/haku?term=car&sivu=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

| Field | Description |
|---|---|
| `urls` | Array of Huutokaupat search result pages. Include query parameters like `term=` and `sivu=` (page number) |
| `max_items_per_url` | Maximum items extracted per search page (default: 20, max: 200) |
| `ignore_url_failures` | If `true`, the scraper continues if a page fails to load instead of halting the entire run |

> **Tip:** Use pagination (`sivu=1`, `sivu=2`, etc.) to scrape multiple pages of the same search. Each search term can yield hundreds of active auctions.

***

### Output Format

**Sample output**

```json
{
  "id": 6364876,
  "title": "Toyota Corolla, 2007",
  "subtitle": "1.4 l, Diesel, 66 kW, Automaatti, 352385 km",
  "description": "<p>-Hyvät kesärenkaat etu 9mm ja taka7mm</p><p>-Hyvät nastarenkaat 9mm pintaa!</p><p>-Automaatti ilmastointi (ei puhalla kylmää)</p><p>-Vetokoukku</p><p>-Jälkiasennettu näyttösoitin</p><p>-Jälkiasennettu peruutuskamera</p><p><br /></p><p><br /></p><p><strong>Tekniset tiedot</strong><br />Teho: <strong>66 kW</strong><br /> CO2-päästöt: <strong>127 g/km</strong><br /> Omamassa <strong>1355 kg</strong><br /><br /><strong>Lisätiedot</strong><br />Katsastus voimassa: <strong>8/2026</strong></p>",
  "class_name": null,
  "city": "Vaasa",
  "zip_code": "65300",
  "region": "15",
  "photo_url": "https://kuvat.huutokaupat.com/ZegJAG5-bhdtt4WJEFm5O4J7ivPzTXFbu7uwxVCaM64/gravity:sm/resize:fit:300:300/czM6Ly9odXV0b2th/dXBhdC1wcm9kLWNk/bi9yZXNvdXJjZXMv/MDE5ZWFiYmQtZGQx/My03M2IwLWFjMjQt/ODQzOTc2NzBkZjMz.jpeg",
  "photo_large_url": "https://kuvat.huutokaupat.com/uKiOHwkj41kmO3ZhuDVFt77HW1drAdmRZ_Fv3C7ihfI/gravity:sm/resize:fit:1600:1600/watermark:0.8:soea:15:5/czM6Ly9odXV0b2th/dXBhdC1wcm9kLWNk/bi9yZXNvdXJjZXMv/MDE5ZWFiYmQtZGQx/My03M2IwLWFjMjQt/ODQzOTc2NzBkZjMz.jpeg",
  "photo_path": "resources/019eabbd-dd13-73b0-ac24-84397670df33",
  "photo_rotation": null,
  "slug": "toyota-corolla-2007",
  "company_id": 7094,
  "company_name": "Prestige Car Center",
  "company_slug": "oy-prestige-consulting-ab",
  "class_id": "Nettihuutokauppa",
  "category_id": 14,
  "category_name": "Henkilöautot",
  "parent_category_id": 2,
  "created_at": "2026-06-09T12:30:44+03:00",
  "updated_at": "2026-06-18T15:00:43+03:00",
  "auction_start": "2026-06-18T15:00:00+03:00",
  "auction_end": "2026-06-21T20:00:00+03:00",
  "original_auction_end": "2026-06-21T20:00:00+03:00",
  "is_cancelled": false,
  "continuous_auction": false,
  "start_price": {
    "amount": 0,
    "vat_percent": 0
  },
  "has_been_bidded": true,
  "bidding_ended": false,
  "bid_count": 12,
  "bidder_count": 6,
  "highest_bid": {
    "amount": 265,
    "vat_percent": 0
  },
  "is_sold_to_highest_bidder": true,
  "is_new": false,
  "view_count": 630,
  "order": 1,
  "minimum_bid_with_vat": 10,
  "minimum_bid_without_vat": 10,
  "metadata": {
    "category": "PassengerCar",
    "base_category": null,
    "registration_status": "1",
    "license_number": "NHE-737",
    "not_registered_reason": null,
    "vehicle_insurance": "1",
    "vin": "JTNBC56E102009399",
    "inspection_status": "1",
    "next_inspection": "8/2026",
    "inspection_fail_reason": null,
    "manufacturer": "Toyota",
    "model": "Corolla",
    "year_model": 2007,
    "commissioning_date": "8/2007",
    "sold_for_fixing": 0,
    "odometer": 352385,
    "fuel_type": "2",
    "engine_displacement": "1.4",
    "drive": "1",
    "transmission": "2",
    "maintenance_book": "1",
    "maintenance_book_description": "Huoltokirjasta kuvat ilmoituksessa.",
    "licensed_twice": "0",
    "licensed_twice_reason": null,
    "withdrawn_from_traffic": null,
    "taxes_overdue": "0",
    "taxes_overdue_amount": null,
    "amount_of_keys": 1,
    "faulty_key_remote": "1",
    "faulty_key_remote_description": null,
    "faulty_windshield": "1",
    "faulty_windshield_description": "Tuulilasissa halkeama KATSO KUVAT!",
    "contains_summer_tires": "1",
    "are_summer_tires_legal": "1",
    "contains_winter_tires": "1",
    "are_winter_tires_legal": "1",
    "faulty_exterior": "1",
    "faulty_exterior_description": "KATSO KUVAT!",
    "faulty_interior": "0",
    "faulty_interior_description": null,
    "warning_indicator": "0",
    "warning_indicator_description": null,
    "additional_fees": null,
    "additional_fees_description": null,
    "is_imported": "0",
    "is_import_tax_paid": null,
    "imported_tax_estimate": null,
    "imported_from": null,
    "is_special_vehicle": false,
    "previous_license_number": null,
    "parts_replaced_percent": null,
    "power": 66,
    "power_type": "kW",
    "no_road_permit": null,
    "emission_manipulation": false,
    "emission_manipulation_description": null,
    "presentation_links": [],
    "vehicle_class": "M1"
  },
  "own_payment": false,
  "vat_perc": 0,
  "group_id": null,
  "is_consumer_net_auction": false,
  "is_fast_bid_period_entry": "$undefined",
  "source": null,
  "delivery_expenses": null,
  "fulfillment_delivery_expenses_unavailable": false,
  "fulfillment_selectable_method": 200,
  "fulfillment_delivery_expenses": 0,
  "fulfillment_retrieval_expenses": 99,
  "processing_cost_amount_with_vat": 46,
  "processing_cost_amount_without_vat": 46,
  "processing_cost_vat_amount": 0,
  "processing_cost_vat_percentage": 0,
  "is_special_entry": false,
  "is_verified_entry": false,
  "custom_badge": null,
  "is_reserve_price_visible": false,
  "is_listed_internationally": false,
  "is_provisionally_eligible_for_ltr_financing": false,
  "favorite_amount": 14,
  "cancelled": false,
  "ended": false,
  "is_own_payment": false,
  "main_photo": "https://kuvat.huutokaupat.com/ZegJAG5-bhdtt4WJEFm5O4J7ivPzTXFbu7uwxVCaM64/gravity:sm/resize:fit:300:300/czM6Ly9odXV0b2th/dXBhdC1wcm9kLWNk/bi9yZXNvdXJjZXMv/MDE5ZWFiYmQtZGQx/My03M2IwLWFjMjQt/ODQzOTc2NzBkZjMz.jpeg",
  "main_photo_path": "resources/019eabbd-dd13-73b0-ac24-84397670df33",
  "main_photo_rotation": null,
  "public_id": 6364876,
  "from_url": "https://huutokaupat.com/en/haku?term=car"
}
```

Each scraped auction returns a detailed record with 61 fields covering product info, auction mechanics, and seller data:

#### Product Identification & Metadata

| Field | Meaning |
|---|---|
| `ID` | Unique auction identifier in Huutokaupat system |
| `Title` | Primary auction item title |
| `Subtitle` | Secondary descriptive text for the item |
| `Description` | Full HTML product description with details |
| `Slug` | URL-friendly product identifier |
| `Public ID` | Public-facing ID used in URLs |

#### Location & Category

| Field | Meaning |
|---|---|
| `City` | Pickup/delivery location city |
| `Zip Code` | Postal code of the item |
| `Region` | Administrative region in Finland |
| `Class Name` | Item classification within category |
| `Category ID` | Unique category identifier |
| `Category Name` | Human-readable category name |
| `Parent Category ID` | Parent category for taxonomy navigation |

#### Photography & Media

| Field | Meaning |
|---|---|
| `Photo URL` | URL to the main product photo |
| `Photo Large URL` | High-resolution version of the photo |
| `Photo Path` | Server path for photo retrieval |
| `Photo Rotation` | Image rotation angle (0, 90, 180, 270) |
| `Main Photo` | Main photo identifier |
| `Main Photo Path` | Path to main photo asset |
| `Main Photo Rotation` | Rotation of main photo |

#### Seller & Company Information

| Field | Meaning |
|---|---|
| `Company ID` | Seller/company unique identifier |
| `Company Name` | Business or seller name |
| `Company Slug` | URL-friendly company identifier |
| `Source` | Origin channel (internal, business account, etc.) |

#### Auction Mechanics & Pricing

| Field | Meaning |
|---|---|
| `Start Price` | Opening bid amount in EUR |
| `Minimum Bid With VAT` | Minimum acceptable bid including VAT |
| `Minimum Bid Without VAT` | Minimum bid excluding VAT |
| `Highest Bid` | Current highest bid amount |
| `Has Been Bidded` | Whether the auction has received bids |
| `Bid Count` | Total number of bids placed |
| `Bidder Count` | Unique number of bidders |
| `Is Sold To Highest Bidder` | Whether item sold at hammer price to top bidder |
| `VAT Percentage` | VAT rate applied to the item |

#### Auction Timeline & Status

| Field | Meaning |
|---|---|
| `Created At` | When the listing was created (ISO timestamp) |
| `Updated At` | Last modification timestamp |
| `Auction Start` | Auction opening date/time |
| `Auction End` | Scheduled auction closing time |
| `Original Auction End` | Original end time before any extensions |
| `Bidding Ended` | Whether active bidding has ceased |
| `Is Cancelled` | Whether the auction was cancelled |
| `Continuous Auction` | Whether bidding can extend beyond end time |
| `Cancelled` | Cancellation status flag |
| `Ended` | Boolean indicating auction conclusion |

#### Engagement & Visibility

| Field | Meaning |
|---|---|
| `View Count` | Number of times the listing was viewed |
| `Favorite Amount` | Number of times added to favorites/watchlist |
| `Order` | Display order in search results |
| `Is New` | Flag indicating recently listed item |

#### Special Flags & Features

| Field | Meaning |
|---|---|
| `Is Verified Entry` | Whether seller verification is confirmed |
| `Is Special Entry` | Premium/featured listing status |
| `Custom Badge` | Custom seller or item badge |
| `Is Reserve Price Visible` | Whether reserve price is publicly shown |
| `Is Listed Internationally` | Available for international bidders |
| `Is Provisionally Eligible For LTR Financing` | Eligible for payment plan financing |
| `Is Consumer Net Auction` | B2C auction designation |
| `Is Fast Bid Period Entry` | Available in fast-bid auctions |
| `Is Own Payment` | Seller payment method flag |
| `Own Payment` | Payment handling method |

#### Fees, Costs & Fulfillment

| Field | Meaning |
|---|---|
| `Delivery Expenses` | Estimated shipping cost |
| `Processing Cost Amount With VAT` | Administrative fee including VAT |
| `Processing Cost Amount Without VAT` | Administrative fee excluding VAT |
| `Processing Cost VAT Amount` | VAT portion of processing cost |
| `Processing Cost VAT Percentage` | VAT rate for processing fee |
| `Fulfillment Delivery Expenses` | Third-party fulfillment shipping cost |
| `Fulfillment Retrieval Expenses` | Cost to retrieve item from warehouse |
| `Fulfillment Delivery Expenses Unavailable` | Flag if delivery cost unavailable |
| `Fulfillment Selectable Method` | Whether buyer can choose delivery option |

#### Additional Metadata

| Field | Meaning |
|---|---|
| `Metadata` | JSON object with item-specific custom fields |
| `Group ID` | Auction group identifier for bulk sales |
| `Class ID` | Item class in category hierarchy |

***

### How to Use

1. **Build your search URLs** — Navigate Huutokaupat.com, perform a search (e.g., `term=car`), and copy the full URL including pagination (`sivu=1`, `sivu=2`, etc.)
2. **Prepare the input** — Paste URLs into the `urls` array. Increase `max_items_per_url` to 200 for maximum extraction.
3. **Enable fault tolerance** — Set `ignore_url_failures: true` for robust bulk scraping across multiple pages.
4. **Run the scraper** — Start the actor and monitor progress in the run log.
5. **Download results** — Export data as JSON, CSV, or Excel for analysis in spreadsheets or databases.

**Common tips:**

- Use specific search terms (`term=car`, `term=phone`) to target relevant auctions.
- Pagination is sequential; loop through `sivu=1` to `sivu=10` for comprehensive coverage.
- Auctions are dynamic; end times, bid counts, and statuses update in real-time.

***

### Use Cases & Business Value

- **Price benchmarking:** Track market values for vehicles, collectibles, and equipment across months
- **Competitive monitoring:** Watch rival sellers' listings, pricing strategies, and inventory turnover
- **Market research:** Analyze auction trends, demand by region, and seasonal patterns
- **Reseller automation:** Feed live auction data into inventory management or alerting systems
- **Financial analysis:** Study liquidation auctions and asset valuation data

The Huutokaupat Product Search Scraper transforms hours of manual browsing into minutes of automated data collection, giving you a competitive edge in market intelligence.

***

### Conclusion

The **Huutokaupat.com Product Search Scraper** delivers reliable, large-scale extraction of auction data with 61 detailed fields per item. Whether you're tracking prices, monitoring competitors, or building data pipelines, this scraper provides the structure and scale needed to turn Huutokaupat into a strategic data source. Start scraping today and unlock insights that drive smarter bidding and business decisions.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the product list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://huutokaupat.com/en/haku?term=car&sivu=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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 = {
    "urls": [
        "https://huutokaupat.com/en/haku?term=car&sivu=2"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/huutokaupat-product-search-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 = {
    "urls": ["https://huutokaupat.com/en/haku?term=car&sivu=2"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/huutokaupat-product-search-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 '{
  "urls": [
    "https://huutokaupat.com/en/haku?term=car&sivu=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/huutokaupat-product-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/huutokaupat-product-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Huutokaupat Product Search Scraper",
        "description": "Scrape product listings from Huutokaupat.com search results instantly. Collect auction titles, pricing, bidding history, seller info, locations, and 60+ fields per item — perfect for market analysis, competitive intelligence, and inventory aggregation.",
        "version": "0.0",
        "x-build-id": "Db6E0lZeDhb1Uw9CL"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~huutokaupat-product-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-huutokaupat-product-search-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/stealth_mode~huutokaupat-product-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-huutokaupat-product-search-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/stealth_mode~huutokaupat-product-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-huutokaupat-product-search-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": {
                    "urls": {
                        "title": "URLs of the product list urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the product list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Continue running even if some URLs fail to be scraped",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped."
                    },
                    "max_items_per_url": {
                        "title": "Max items per URL",
                        "type": "integer",
                        "description": "The maximum number of items to scrape per URL."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
