# Oglaszamy24.pl Classified Ads Scraper (`trev0n/oglaszamy24-scraper`) Actor

Scrape classified ads from Oglaszamy24.pl - listings, search results, and full ad details with seller contact information.

- **URL**: https://apify.com/trev0n/oglaszamy24-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Categories:** Automation, Lead generation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$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 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

## 📰 Oglaszamy24.pl Classified Ads Scraper

🎯 **Pull every classified ad you need from Oglaszamy24.pl — full descriptions, prices, photos, attributes, and seller contacts — straight into a clean dataset.**

This scraper collects **structured ad data** from one of Poland's long-running classifieds portals: titles, prices in PLN, full descriptions, category breadcrumbs, location, attributes (year, mileage, model, condition, ...), photo galleries, view counts, and seller contact details (name & phone). It works on the main domain and on every city subdomain (Warszawa, Kraków, Łódź, Wrocław, Poznań, Gdańsk, and many more).

---

### 🚀 What Does It Do?

This scraper automatically crawls Oglaszamy24.pl listings, search results, and category pages — then opens each ad to pull the **full record**. No manual browsing, no copy-paste, no spreadsheet juggling. Just set your filters and hit Start.

💡 **Two modes of operation:**

1. **🔍 Discovery Mode** — Provide a keyword, a city, and/or a category path. The scraper builds the right search URL on the matching subdomain, paginates through all result pages, and pulls every matching ad.
2. **📋 Direct URL Mode** — Drop in any mix of category pages, search result URLs, city subdomain pages, or even individual ad URLs. The scraper figures out the type and processes each one accordingly.

---

### 👥 Who Is This For?

| 🏢 Use Case                            | 💬 How It Helps                                                                                              |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| 🚗 **Used-car & motorcycle resellers** | Track motoryzacja listings across cities — find new offers, compare prices, build your inventory feed        |
| 🏠 **Real-estate professionals**       | Monitor nieruchomości listings (mieszkania, domy, działki) by city — react to fresh offers within minutes    |
| 📈 **Market researchers & analysts**   | Build pricing datasets across categories and regions — measure supply, demand, and price evolution over time |
| 🤝 **Lead generation & sales teams**   | Collect seller phone numbers and names from publicly listed business and service ads (uslugi-i-firmy)        |
| 🛍️ **Bargain hunters & arbitrageurs**  | Snipe underpriced ads in dom-i-ogrod, elektronika, and motoryzacja before competitors find them              |
| 🧑‍💻 **Data scientists & ML teams**      | Train pricing models on real Polish classifieds data with full attribute coverage                            |

---

### ✨ Features

- 🌐 **Full domain coverage** — Main www and every city subdomain (Warszawa, Kraków, Gdańsk, Poznań, Wrocław, Łódź, Szczecin, Lublin, Białystok, Katowice, Bydgoszcz, and many more)
- 📋 **Listing + Detail extraction** — Choose between fast listing-only mode or deep-dive mode that opens every ad
- 💰 **Price parsing** — Numeric price plus detected currency (PLN by default; EUR/USD when present)
- 🏷️ **Attribute capture** — Every key/value the seller filled in: year, mileage, model, engine type, condition, area, rooms, etc.
- 📸 **Photo galleries** — Main photo plus every thumbnail in the gallery, as direct image URLs
- 📞 **Seller contacts** — Name and phone number when publicly displayed
- 📅 **Smart date parsing** — Polish date formats (`Dzisiaj 12:28`, `3 Maj 2026 12:22`) parsed into clean ISO-8601 timestamps
- 🗺️ **Category & city tagging** — Every ad tagged with its category breadcrumb and originating city subdomain
- 🎛️ **Smart Filters** — Search by keyword, narrow by city subdomain, restrict to a category path, cap by max items
- 🧹 **Deduplication** — Same ad URL is never scraped twice, even across paginated results
- ⚡ **Fast & Scalable** — HTTP-only crawler, hundreds of ads per minute on a single run
- 📤 **Export Anywhere** — Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

---

### 🎛️ Filters & Options

| Option                      | What It Does                                                                                                            |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| 🔗 **Start URLs**           | Drop in any category page, search result, city subdomain, or single ad URL — the scraper detects the type automatically |
| 🔎 **Search keyword**       | Free-text phrase added to the search query (e.g. `samochód`, `mieszkanie`, `iphone`)                                    |
| 🏙️ **City**                 | Pick a city to scrape only from its subdomain (e.g. `Warszawa`, `Kraków`, `Gdańsk`) — diacritics handled                |
| 📂 **Category path**        | Restrict to a category, e.g. `motoryzacja/motocykle` or `nieruchomosci/mieszkania`                                      |
| 🔢 **Max Items**            | Cap the number of ads scraped per run (set to 0 for unlimited)                                                          |
| 🔬 **Extract full details** | Toggle deep-dive mode — opens every ad page to pull description, attributes, photos, and contacts                       |
| 🚦 **Rate limit**           | Throttle requests per minute to stay friendly with the server                                                           |
| 🌐 **Proxy**                | Optional Apify Proxy support for high-volume runs                                                                       |

---

### 📦 What You Get (Output Fields)

Every ad record includes:

#### Identification

| Field | Example                                                                                         |
| ----- | ----------------------------------------------------------------------------------------------- |
| adId  | `42834462`                                                                                      |
| title | `Honda wk1 VTR 1000 SP Power 170KM Vintage`                                                     |
| url   | `https://www.oglaszamy24.pl/ogloszenie/42834462/Honda-wk1-VTR-1000-SP-Power-170KM-Vintage.html` |

#### Content

| Field       | Example                                                                                       |
| ----------- | --------------------------------------------------------------------------------------------- |
| description | `Witam .. Motocykl Honda VTR 1000 SP Tuningowy wk1 na zamówienie .. motocykl stan idealny ..` |
| adType      | `Sprzedam`                                                                                    |
| category    | `Motoryzacja / Motocykle`                                                                     |
| city        | `www`                                                                                         |

#### Pricing

| Field    | Example  |
| -------- | -------- |
| price    | `100000` |
| currency | `PLN`    |

#### Attributes

| Field      | Example                                                                                                                                               |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| attributes | `{ "Model": "VTR 1000 SP", "Uszkodzony": "Nie", "Przebieg": "30000 km", "Rok produkcji": "2003", "Typ silnika": "Benzyna", "Pojemność": "1000 cm3" }` |

#### Seller contact

| Field        | Example        |
| ------------ | -------------- |
| contactName  | `witek kalmus` |
| contactPhone | `504436527`    |

#### Media

| Field     | Example                                                     |
| --------- | ----------------------------------------------------------- |
| thumbnail | `https://www.oglaszamy24.pl/storage/48/27/62de5da4_s.jpg`   |
| photos    | `["https://www.oglaszamy24.pl/storage/48/27/62de5da4.jpg"]` |

#### Timestamps & metrics

| Field         | Example                    |
| ------------- | -------------------------- |
| publishedDate | `2026-05-03T12:22:00.000Z` |
| publishedRaw  | `3 Maj 2026 12:22`         |
| viewCount     | `49`                       |
| scrapedAt     | `2026-05-03T12:35:11.842Z` |

---

### 📊 Example Output

```json
{
	"adId": "42834462",
	"title": "Honda wk1 VTR 1000 SP Power 170KM Vintage",
	"url": "https://www.oglaszamy24.pl/ogloszenie/42834462/Honda-wk1-VTR-1000-SP-Power-170KM-Vintage.html",
	"description": "Witam .. Motocykl Honda VTR 1000 SP Tuningowy wk1 na zamówienie .. motocykl stan idealny .. wszystko stan perfekt .. Motocykl Tuningowy WK1 - power 170 KM .. waga motocykla ok. 180 kg .. polecam wspanialą maszyne .. motocykl duza moc Tuning wk1 Vintage .. zdjecia concept wk1 .. odpowiadam szybko email .. Pozdrawiam",
	"price": 100000,
	"currency": "PLN",
	"adType": "Sprzedam",
	"publishedDate": "2026-05-03T12:22:00.000Z",
	"publishedRaw": "3 Maj 2026 12:22",
	"city": "www",
	"category": "Motoryzacja / Motocykle",
	"attributes": {
		"Model": "VTR 1000 SP",
		"Uszkodzony": "Nie",
		"Przebieg": "30000 km",
		"Rok produkcji": "2003",
		"Typ silnika": "Benzyna",
		"Pojemność": "1000 cm3"
	},
	"contactName": "witek kalmus",
	"contactPhone": "504436527",
	"photos": ["https://www.oglaszamy24.pl/storage/48/27/62de5da4.jpg"],
	"thumbnail": "https://www.oglaszamy24.pl/storage/48/27/62de5da4_s.jpg",
	"viewCount": 49,
	"scrapedAt": "2026-05-03T12:35:11.842Z"
}
````

***

### 📋 Dataset Views

The Apify Console gives you **4 ready-made table views** to quickly browse your results:

| View                   | What It Shows                                                           |
| ---------------------- | ----------------------------------------------------------------------- |
| 📊 **Overview**        | Title, price, currency, city, category, publish date, ad URL            |
| 📞 **Seller contacts** | Title, seller name, phone, city, price, ad URL — perfect for lead lists |
| 📸 **Photos**          | Title, thumbnail preview, full photo gallery URLs                       |
| 📋 **Full details**    | Every single field — the complete dataset                               |

***

### ❓ FAQ

**🤔 Does it work for every category?**
Yes — every category and subcategory on Oglaszamy24.pl is supported (motoryzacja, nieruchomości, dom-i-ogrod, elektronika, praca, uslugi-i-firmy, sport, nauka-i-ksiazki, and more). Just point it at the category URL or pass the path in the **Category** field.

**🤔 Does it cover city subdomains?**
Yes — Warszawa, Kraków, Łódź, Wrocław, Poznań, Gdańsk, Szczecin, Bydgoszcz, Lublin, Białystok, Katowice, Gdynia, Częstochowa, Radom, Sosnowiec, Toruń, Kielce, Rzeszów, Gliwice, Olsztyn, Zabrze, Bytom, Bielsko-Biała, Wałbrzych, Kalisz, Płock, Opole, and more. Pass the city name (with or without Polish diacritics) and the right subdomain is used automatically.

**🤔 Are seller phone numbers really included?**
Yes — Oglaszamy24.pl displays phone numbers publicly on most ads. The scraper captures whatever the seller chose to publish.

**🤔 Will it handle Polish characters correctly?**
Yes — the site serves ISO-8859-2 (Latin-2) and the scraper transparently decodes it into clean UTF-8. All ą, ć, ę, ł, ń, ó, ś, ź, ż come through untouched.

**🤔 Can I export the data?**
Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 How often should I run this?**
For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks.

**🤔 Does it work with proxies?**
Yes — residential proxies are recommended for the best results at very high volumes. The scraper works with Apify's built-in proxy service. For most runs you don't need a proxy at all.

***

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional filters (price range, year range, mileage cap, distance from a city, only ads with photos, only ads with phone)
- 📊 Extra data fields or custom output formats (e.g. flatten attributes into top-level columns, normalize price to a single currency)
- 🔄 Integration with your CRM, Google Sheets, or database
- ⏰ Scheduled scraping with automatic deduplication and incremental updates
- 🌐 Scraping from other classifieds platforms alongside Oglaszamy24 (OLX, Gratka, Otodom, Otomoto, Sprzedajemy.pl)

👉 **Don't hesitate to reach out via private message** — I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

***

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available information** from Oglaszamy24.pl. It does not access private data, bypass authentication, or scrape content protected behind a login. Please use the data responsibly and in compliance with applicable laws (including GDPR when handling phone numbers and names) and the platform's terms of service.

# Actor input Schema

## `startUrls` (type: `array`):

Direct URLs to scrape. Accepts category pages (e.g. https://www.oglaszamy24.pl/ogloszenia/motoryzacja/motocykle/), search result pages, city subdomain pages (e.g. https://warszawa.oglaszamy24.pl/), or individual ad pages. Leave empty to use the keyword/city/category fields below.

## `keyword` (type: `string`):

Optional search phrase. Used together with city and/or category to build a search URL.

## `city` (type: `string`):

Optional city name. The scraper resolves it to the matching city subdomain (e.g. 'Warszawa' -> warszawa.oglaszamy24.pl).

## `category` (type: `string`):

Optional category path, e.g. 'motoryzacja/motocykle' or 'nieruchomosci/mieszkania'.

## `maxItems` (type: `integer`):

Maximum number of ads to scrape. Set to 0 for unlimited.

## `extractFullDetails` (type: `boolean`):

If enabled, the scraper visits every ad page to extract full description, attributes (year, mileage, model, ...), photos, view count, and seller contact information. Disable to keep results limited to listing-level data (faster, cheaper).

## `maxConcurrency` (type: `integer`):

Maximum number of concurrent HTTP requests. The site rate-limits aggressively at high concurrency, so values above 6 are not recommended without a residential proxy.

## `maxRequestRetries` (type: `integer`):

Maximum number of retries for failed/rate-limited requests.

## `maxRequestsPerMinute` (type: `integer`):

Rate limit cap for HTTP requests.

## `proxyConfiguration` (type: `object`):

Optional proxy settings. The site responds well without proxies; configure only if you hit rate limits at very high concurrency.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.oglaszamy24.pl/ogloszenia/motoryzacja/motocykle/"
    }
  ],
  "keyword": "samochód",
  "city": "Warszawa",
  "category": "motoryzacja/motocykle",
  "maxItems": 100,
  "extractFullDetails": true,
  "maxConcurrency": 4,
  "maxRequestRetries": 5,
  "maxRequestsPerMinute": 60,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `contacts` (type: `string`):

No description

## `photos` (type: `string`):

No description

## `detailed` (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 = {
    "startUrls": [
        {
            "url": "https://www.oglaszamy24.pl/ogloszenia/motoryzacja/motocykle/"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/oglaszamy24-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 = { "startUrls": [{ "url": "https://www.oglaszamy24.pl/ogloszenia/motoryzacja/motocykle/" }] }

# Run the Actor and wait for it to finish
run = client.actor("trev0n/oglaszamy24-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 '{
  "startUrls": [
    {
      "url": "https://www.oglaszamy24.pl/ogloszenia/motoryzacja/motocykle/"
    }
  ]
}' |
apify call trev0n/oglaszamy24-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Oglaszamy24.pl Classified Ads Scraper",
        "description": "Scrape classified ads from Oglaszamy24.pl - listings, search results, and full ad details with seller contact information.",
        "version": "0.0",
        "x-build-id": "9faXPVJtE5skTBYWP"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/trev0n~oglaszamy24-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-trev0n-oglaszamy24-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/trev0n~oglaszamy24-scraper/runs": {
            "post": {
                "operationId": "runs-sync-trev0n-oglaszamy24-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/trev0n~oglaszamy24-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-trev0n-oglaszamy24-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "Direct URLs to scrape. Accepts category pages (e.g. https://www.oglaszamy24.pl/ogloszenia/motoryzacja/motocykle/), search result pages, city subdomain pages (e.g. https://warszawa.oglaszamy24.pl/), or individual ad pages. Leave empty to use the keyword/city/category fields below.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "keyword": {
                        "title": "Search keyword",
                        "type": "string",
                        "description": "Optional search phrase. Used together with city and/or category to build a search URL."
                    },
                    "city": {
                        "title": "City",
                        "type": "string",
                        "description": "Optional city name. The scraper resolves it to the matching city subdomain (e.g. 'Warszawa' -> warszawa.oglaszamy24.pl)."
                    },
                    "category": {
                        "title": "Category path",
                        "type": "string",
                        "description": "Optional category path, e.g. 'motoryzacja/motocykle' or 'nieruchomosci/mieszkania'."
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of ads to scrape. Set to 0 for unlimited.",
                        "default": 100
                    },
                    "extractFullDetails": {
                        "title": "Extract full ad details",
                        "type": "boolean",
                        "description": "If enabled, the scraper visits every ad page to extract full description, attributes (year, mileage, model, ...), photos, view count, and seller contact information. Disable to keep results limited to listing-level data (faster, cheaper).",
                        "default": true
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "Maximum number of concurrent HTTP requests. The site rate-limits aggressively at high concurrency, so values above 6 are not recommended without a residential proxy.",
                        "default": 4
                    },
                    "maxRequestRetries": {
                        "title": "Max request retries",
                        "minimum": 0,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Maximum number of retries for failed/rate-limited requests.",
                        "default": 5
                    },
                    "maxRequestsPerMinute": {
                        "title": "Max requests per minute",
                        "minimum": 10,
                        "maximum": 600,
                        "type": "integer",
                        "description": "Rate limit cap for HTTP requests.",
                        "default": 60
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Optional proxy settings. The site responds well without proxies; configure only if you hit rate limits at very high concurrency.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
