# A101 Scraper $1💰 Prices, Stock, Images & Campaigns (`abotapi/a101-product-scraper`) Actor

Scrape a101.com.tr products across A101 Ekstra and A101 Kapıda. 80+ fields: title, brand, barcode, category, price (normal/discounted/rate), images, stock rules, channels, origin, campaigns, promotions, badges, variants, description. Search and URL modes, price/brand/stock filters and sorting.

- **URL**: https://apify.com/abotapi/a101-product-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 product 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

## A101 Product Scraper

Collect structured product data from **a101.com.tr**, one of Turkey's largest discount retailers, across both the **A101 Ekstra** online range and the **A101 Kapida** doorstep range. Search by keyword or paste product and search URLs, and get back a clean record per product with prices, discounts, stock, images, categories, brands, campaigns and more.

### Why this scraper

- **80+ fields per product** covering identifiers, full pricing, stock rules, sales channels, origin, campaigns and media, far beyond a basic title and price.
- **Deals / specials views**: scrape A101's **Aldın Aldın** promotional listings (weekly deals, plus Electronics and Home & Living) directly, in one click, or paste any promo listing URL.
- **Was-price and savings on every discounted product**: current price, original (was) price, discount amount, discount percentage and an `is_on_special` flag, all split into clean fields.
- **Two catalogues in one** actor: A101 Ekstra and A101 Kapida, selectable per search.
- **Search and URL modes**: build searches from keyword terms and filters, or paste a101.com.tr search, deals and product URLs.
- **Price, brand and stock filters** plus five sort orders, so you collect exactly the slice you want.
- **Export to your apps** through MCP connectors (Notion, Linear, Airtable, Apify).
- **Clean Turkish lira pricing** with normal price, discounted price and discount rate already separated.

### Data you get

> Sample shape  - values are illustrative placeholders, not from a live listing.

| Field | Example |
|-------|---------|
| product_id | `00000000` |
| barcode | `0000000000000` |
| title | `Sample Coffee Beans 1000 G` |
| brand | `Sample Brand` |
| category_path | `Market > Beverages > Coffee` |
| current_price | `99.90` |
| original_price | `149.90` |
| discounted_price | `99.90` |
| discount_rate | `33` |
| is_on_special | `true` |
| savings_amount | `50.00` |
| savings_percent | `33` |
| promo_label | `%33 İNDİRİM` |
| specials_category | `aldin-aldin` |
| pack_size | `1000 g` |
| currency | `TRY` |
| in_stock | `true` |
| channel_names | `["A101 Online", "Magaza", "A101 Kapida"]` |
| origin_country | `Sample Country` |
| min_quantity | `1` |
| max_quantity | `5` |
| return_days | `15` |
| vat_rate | `1` |
| variant_count | `1` |
| primary_image_url | `https://cdn2.a101.com.tr/.../1.jpg` |
| collections | `[{"id": "S0000000", "name": "Sample Campaign"}]` |
| promotions | `[{"id": "promo-0", "name": "Sample Promotion"}]` |
| badges | `[{"id": "badge-0", "text": "Sample Badge"}]` |
| url | `https://www.a101.com.tr/.../sample_p-00000000` |

A101 does not publish customer reviews or star ratings on its product pages, so the `rating` and `review_count` fields are always empty. See "Reviews and ratings" below.

### How to use

**Search by keyword (A101 Ekstra):**

```json
{
  "mode": "search",
  "queries": ["kahve", "deterjan"],
  "channel": "ekstra",
  "maxListings": 100
}
````

**Scrape a deals / specials view (Aldın Aldın):**

```json
{
  "mode": "search",
  "specialsCategory": "aldin-aldin",
  "maxListings": 200
}
```

The specials views are `aldin-aldin` (weekly deals), `aldin-aldin-elektronik` (electronics) and `aldin-aldin-ev-yasam` (home & living). Each discounted product carries `original_price`, `savings_amount`, `savings_percent` and `promo_label` alongside the current price. You can also add keyword `queries` to run them in the same run, or price/brand/stock filters and sorting to narrow the deals. To scrape any other promo or category listing, switch to URL mode and paste its page URL.

**Search with filters and sorting:**

```json
{
  "mode": "search",
  "queries": ["kahve"],
  "minPrice": 50,
  "maxPrice": 500,
  "brand": "Tchibo",
  "inStockOnly": true,
  "sortBy": "price-asc",
  "maxListings": 50
}
```

**Paste URLs (search or product pages):**

```json
{
  "mode": "url",
  "urls": [
    "https://www.a101.com.tr/arama?k=su",
    "https://www.a101.com.tr/market/sample-product_p-00000000"
  ],
  "maxListings": 40
}
```

### Input parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `mode` | select | `search` (keyword + filters) or `url` (paste a101.com.tr URLs). Required. |
| `queries` | array | Keyword terms to search. One search runs per term. Search mode only. |
| `channel` | select | Catalogue to search: `ekstra` (A101 Ekstra) or `kapida` (A101 Kapida). Search mode only. |
| `minPrice` | integer | Keep products with a current price at or above this value, in TRY. Search mode only. |
| `maxPrice` | integer | Keep products with a current price at or below this value, in TRY. Search mode only. |
| `brand` | string | Keep only products of this exact brand (case-insensitive). Search mode only. |
| `inStockOnly` | boolean | Drop out-of-stock products. Search mode only. |
| `sortBy` | select | `relevance`, `price-asc`, `price-desc`, `discount-desc`, `name-asc`. Search mode only. |
| `specialsCategory` | select | Optionally scrape an Aldın Aldın deals view: `aldin-aldin`, `aldin-aldin-elektronik` or `aldin-aldin-ev-yasam`. Empty for a normal keyword search. Search mode only. |
| `urls` | array | a101.com.tr search, deals or product URLs. URL mode only. Filter fields above are ignored in this mode. |
| `maxPages` | integer | Optional per-search page ceiling. Empty or 0 means no page limit; defers to Max products. |
| `maxListings` | integer | The single hard cap on total products collected. Default 20. Set 0 for unlimited. |
| `proxy` | object | Proxy configuration. The default Apify proxy works well. |
| `mcpConnectors` | array | Optional MCP connectors to also receive the results (Notion, Linear, Airtable, Apify). |
| `notionParentPageUrl` | string | Notion parent page URL or id, required only for the Notion connector. |
| `maxNotifyListings` | integer | Cap on items sent to each connector per run. Does not affect the dataset. |

### Output example

> Sample shape  - values are illustrative placeholders, not from a live listing.

```json
{
  "product_id": "00000000",
  "base_id": "00000000",
  "barcode": "0000000000000",
  "title": "Sample Coffee Beans 1000 G",
  "seo_name": "Sample Coffee Beans 1000 G",
  "url": "https://www.a101.com.tr/market/sample-coffee-beans-1000-g_p-00000000",
  "country": "TR",
  "brand": "Sample Brand",
  "brand_url": "https://www.a101.com.tr/markalar/sample-brand",
  "category": "Coffee",
  "category_path": "Market > Beverages > Coffee",
  "currency": "TRY",
  "current_price": 99.90,
  "original_price": 149.90,
  "discounted_price": 99.90,
  "current_price_text": "TRY 99,00",
  "discount_rate": 33,
  "is_on_special": true,
  "savings_amount": 50.00,
  "savings_percent": 33,
  "promo_label": "%33 İNDİRİM",
  "specials_category": "aldin-aldin",
  "pack_size": "1000 g",
  "in_stock": true,
  "is_enabled": true,
  "min_quantity": 1,
  "max_quantity": 5,
  "return_days": 15,
  "vat_rate": 1,
  "channel_names": ["A101 Online", "Magaza", "A101 Kapida"],
  "origin_country": "Sample Country",
  "images": [{ "id": "1.jpg", "url": "https://cdn2.a101.com.tr/.../1.jpg", "type": "product" }],
  "primary_image_url": "https://cdn2.a101.com.tr/.../1.jpg",
  "image_count": 1,
  "collections": [{ "id": "S0000000", "name": "Sample Campaign" }],
  "variant_count": 1,
  "short_description": "Sample short description.",
  "rating": null,
  "review_count": null
}
```

### Reviews and ratings

A101 product pages do **not** include a customer reviews or star-rating feature. The catalogue exposes product, price, stock, campaign and media data only; there is no ratings summary, no individual reviews and no review count anywhere on the product pages or in the product data. The output keeps `rating` and `review_count` fields for a stable schema, but both are always empty. If A101 adds a reviews feature in the future, these fields are ready to carry it.

### Send results into your apps (MCP connectors)

You can optionally pipe each run's results into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then list it in `mcpConnectors`. Each connector receives a condensed, human-readable summary per item (title plus key fields); the complete record always stays in the dataset. Supported connectors include Notion, Linear, Airtable and Apify. For the Notion connector, set `notionParentPageUrl` to the page under which item pages are created.

### Plan requirement

This actor runs on any Apify account. Using the default Apify proxy is recommended for reliable, uninterrupted collection.

# Actor input Schema

## `mode` (type: `string`):

search = build searches from query terms + filters. url = paste one or more a101.com.tr search or product URLs.

## `queries` (type: `array`):

Product terms to search, e.g. kahve, su, deterjan, Dove. One search runs per term. Only applies when mode = search.

## `channel` (type: `string`):

Which A101 catalogue to search. A101 Ekstra is the full online range; A101 Kapida is the doorstep range. Only applies when mode = search.

## `minPrice` (type: `integer`):

Keep only products with a current price at or above this value, in Turkish lira. Only applies when mode = search.

## `maxPrice` (type: `integer`):

Keep only products with a current price at or below this value, in Turkish lira. Only applies when mode = search.

## `brand` (type: `string`):

Keep only products of this exact brand (case-insensitive), e.g. Tchibo. Leave empty for all brands. Only applies when mode = search.

## `inStockOnly` (type: `boolean`):

When on, drops products that are out of stock. Only applies when mode = search.

## `sortBy` (type: `string`):

Order of the collected products. Only applies when mode = search.

## `specialsCategory` (type: `string`):

Optionally scrape a promotional listing instead of (or alongside) your keyword searches. A101's flagship deals event is Aldın Aldın. Leave as None for a normal keyword search. Only applies when mode = search. To scrape any other promo or category listing, switch to URL mode and paste its page URL.

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

Paste one or more a101.com.tr search URLs (the page reads the query) or product page URLs. Multi-URL supported. Filter fields above are ignored in this mode. Searches walk pages forward automatically.

## `maxPages` (type: `integer`):

Optional safety stop on how many result pages to read per query/URL (about 100 products per page). This does NOT cap the run: leave it empty (or 0) for unlimited pages and the run is bounded solely by Max products. Set a value only if you also want a per-search page ceiling.

## `maxListings` (type: `integer`):

The run's single hard cap: maximum total products across all searches and URLs. Defaults to 20. Set 0 for unlimited. This is the only default limit; Max pages is unlimited by default and defers to this.

## `proxy` (type: `object`):

Connection used to reach the site. The default Apify proxy works well; no special configuration is required.

## `mcpConnectors` (type: `array`):

Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com).

## `notionParentPageUrl` (type: `string`):

URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "queries": [
    "kahve"
  ],
  "channel": "ekstra",
  "inStockOnly": false,
  "sortBy": "relevance",
  "specialsCategory": "",
  "urls": [
    "https://www.a101.com.tr/arama?k=kahve"
  ],
  "maxListings": 20,
  "proxy": {
    "useApifyProxy": true
  },
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (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 = {
    "mode": "search",
    "queries": [
        "kahve"
    ],
    "urls": [
        "https://www.a101.com.tr/arama?k=kahve"
    ],
    "proxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/a101-product-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 = {
    "mode": "search",
    "queries": ["kahve"],
    "urls": ["https://www.a101.com.tr/arama?k=kahve"],
    "proxy": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/a101-product-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 '{
  "mode": "search",
  "queries": [
    "kahve"
  ],
  "urls": [
    "https://www.a101.com.tr/arama?k=kahve"
  ],
  "proxy": {
    "useApifyProxy": true
  }
}' |
apify call abotapi/a101-product-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "A101 Scraper $1💰 Prices, Stock, Images & Campaigns",
        "description": "Scrape a101.com.tr products across A101 Ekstra and A101 Kapıda. 80+ fields: title, brand, barcode, category, price (normal/discounted/rate), images, stock rules, channels, origin, campaigns, promotions, badges, variants, description. Search and URL modes, price/brand/stock filters and sorting.",
        "version": "1.0",
        "x-build-id": "hsB4tQZB9OVPeG0r9"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/abotapi~a101-product-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-abotapi-a101-product-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/abotapi~a101-product-scraper/runs": {
            "post": {
                "operationId": "runs-sync-abotapi-a101-product-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/abotapi~a101-product-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-abotapi-a101-product-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": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Search mode",
                        "enum": [
                            "search",
                            "url"
                        ],
                        "type": "string",
                        "description": "search = build searches from query terms + filters. url = paste one or more a101.com.tr search or product URLs.",
                        "default": "search"
                    },
                    "queries": {
                        "title": "Search queries",
                        "type": "array",
                        "description": "Product terms to search, e.g. kahve, su, deterjan, Dove. One search runs per term. Only applies when mode = search.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "channel": {
                        "title": "Catalogue",
                        "enum": [
                            "ekstra",
                            "kapida"
                        ],
                        "type": "string",
                        "description": "Which A101 catalogue to search. A101 Ekstra is the full online range; A101 Kapida is the doorstep range. Only applies when mode = search.",
                        "default": "ekstra"
                    },
                    "minPrice": {
                        "title": "Min price (TRY)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Keep only products with a current price at or above this value, in Turkish lira. Only applies when mode = search."
                    },
                    "maxPrice": {
                        "title": "Max price (TRY)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Keep only products with a current price at or below this value, in Turkish lira. Only applies when mode = search."
                    },
                    "brand": {
                        "title": "Brand",
                        "type": "string",
                        "description": "Keep only products of this exact brand (case-insensitive), e.g. Tchibo. Leave empty for all brands. Only applies when mode = search."
                    },
                    "inStockOnly": {
                        "title": "In-stock products only",
                        "type": "boolean",
                        "description": "When on, drops products that are out of stock. Only applies when mode = search.",
                        "default": false
                    },
                    "sortBy": {
                        "title": "Sort order",
                        "enum": [
                            "relevance",
                            "price-asc",
                            "price-desc",
                            "discount-desc",
                            "name-asc"
                        ],
                        "type": "string",
                        "description": "Order of the collected products. Only applies when mode = search.",
                        "default": "relevance"
                    },
                    "specialsCategory": {
                        "title": "Specials / deals view",
                        "enum": [
                            "",
                            "aldin-aldin",
                            "aldin-aldin-elektronik",
                            "aldin-aldin-ev-yasam"
                        ],
                        "type": "string",
                        "description": "Optionally scrape a promotional listing instead of (or alongside) your keyword searches. A101's flagship deals event is Aldın Aldın. Leave as None for a normal keyword search. Only applies when mode = search. To scrape any other promo or category listing, switch to URL mode and paste its page URL.",
                        "default": ""
                    },
                    "urls": {
                        "title": "A101 URLs",
                        "type": "array",
                        "description": "Paste one or more a101.com.tr search URLs (the page reads the query) or product page URLs. Multi-URL supported. Filter fields above are ignored in this mode. Searches walk pages forward automatically.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxPages": {
                        "title": "Max pages per search",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Optional safety stop on how many result pages to read per query/URL (about 100 products per page). This does NOT cap the run: leave it empty (or 0) for unlimited pages and the run is bounded solely by Max products. Set a value only if you also want a per-search page ceiling."
                    },
                    "maxListings": {
                        "title": "Max products",
                        "minimum": 0,
                        "type": "integer",
                        "description": "The run's single hard cap: maximum total products across all searches and URLs. Defaults to 20. Set 0 for unlimited. This is the only default limit; Max pages is unlimited by default and defers to this.",
                        "default": 20
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Connection used to reach the site. The default Apify proxy works well; no special configuration is required."
                    },
                    "mcpConnectors": {
                        "title": "Pipe results into your apps (optional)",
                        "type": "array",
                        "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)."
                    },
                    "notionParentPageUrl": {
                        "title": "Notion parent page (Notion connector only)",
                        "type": "string",
                        "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors."
                    },
                    "maxNotifyListings": {
                        "title": "Max items to export per connector",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Cap on items written to each connector per run. Does not affect the dataset.",
                        "default": 50
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
