# Meta Ads Library Scraper | 💵$0.5/1K (`webdata_labs/meta-ads-library-scraper`) Actor

\[💵 $0.50 / 1K] Track competitors by Facebook Page ID or discover ads by keyword and optional date range. Export public Meta, Facebook, and Instagram ads.

- **URL**: https://apify.com/webdata\_labs/meta-ads-library-scraper.md
- **Developed by:** [WebData Labs](https://apify.com/webdata_labs) (community)
- **Categories:** Social media, Automation, Developer tools
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.40 / 1,000 meta ads library ads

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

**Scrape public Facebook and Instagram ads from the [Meta Ads Library](https://www.facebook.com/ads/library/) by keyword, Facebook Page ID, or copied search URL.**

> **Track specific competitors' ads by Facebook Page ID, or discover competitors and winning ad ideas by keyword.**

Meta Ads Library Scraper returns one clean dataset row per public ad, including copy, creatives, CTAs, landing pages, advertiser details, platforms, and dates. Optionally filter ads by a period in which they were active. No Facebook login or Meta developer token is required.

### ✅ What you get / ❌ What this isn't

✅ You get:

- Ad copy, headlines, descriptions, CTA, and landing-page URLs
- Image, video, thumbnail, carousel, and dynamic-creative assets
- Advertiser Page ID, name, URL, categories, image, and public like count
- Active status, start/end dates, platforms, and Meta Library IDs
- Spend, impressions, reach, currency, and country fields when Meta publicly exposes them
- Keyword, Page ID, and copied Ads Library URL inputs
- Optional server-side filtering by a period in which ads were active

### 🔎 Why use this Meta Ads Library scraper

Use a **Facebook Page ID** when you already know the competitor you want to track. Use a **keyword or advertiser name** when you want to discover who is advertising in a market, compare offers and CTAs, or collect fresh creative ideas.

Schedule repeat exports for competitor tracking, call the Actor through the API, export datasets, trigger webhooks, or connect results to Make, Zapier, Google Sheets, and other integrations.

### 📊 What data can it extract?

| Field                                    | Description                                                  |
| ---------------------------------------- | ------------------------------------------------------------ |
| `libraryId`, `adUrl`                     | Stable Meta Library ID and public detail URL                 |
| `pageId`, `pageName`, `pageUrl`          | Advertiser identity                                          |
| `bodyText`, `headline`, `description`    | Cleaned creative copy                                        |
| `ctaText`, `landingPageUrl`              | Call to action and destination                               |
| `imageUrls`, `videoUrls`, `cards`        | Creative assets and carousel cards                           |
| `isActive`, `startDate`, `endDate`       | Delivery status and dates                                    |
| `publisherPlatforms`                     | Facebook, Instagram, Messenger, and other exposed placements |
| `spend`, `impressions`, `reachEstimate`  | Transparency ranges when available                           |
| `sourceValue`, `sourceUrl`, `observedAt` | Search provenance                                            |

### ⚙️ How to scrape Meta Ads Library

1. Enter one or more advertiser names or keywords.
2. Optionally add numeric Facebook Page IDs or copied Meta Ads Library URLs.
3. Optionally choose the earliest and/or latest ad start date.
4. Choose the country, status, media type, and maximum result count.
5. Run the Actor.
6. Download the dataset as JSON, CSV, Excel, XML, or another Apify-supported format.

No Facebook access token, login, or user-provided cookies are required.

### 📥 Input

Choose either `searchQueries` for market discovery or `pageIds` for exact competitor tracking. You can also provide both.

**Discover competitors and ad ideas by keyword:**

```json
{
    "searchQueries": ["shopify"],
    "pageIds": [],
    "countryCode": "US",
    "activeStatus": "active",
    "mediaType": "all",
    "maxResults": 100
}
````

**Track ads from a specific competitor:**

```json
{
    "searchQueries": [],
    "pageIds": ["20409006880"],
    "countryCode": "US",
    "activeStatus": "active",
    "maxResults": 100
}
```

**Extract ads that were active during a period:**

```json
{
    "searchQueries": ["shopify"],
    "pageIds": [],
    "countryCode": "US",
    "activeStatus": "active",
    "dateFrom": "2026-07-01",
    "dateTo": "2026-07-23",
    "maxResults": 100
}
```

- `searchQueries` - keywords or advertiser names for discovering competitors and ad ideas.
- `pageIds` - numeric Facebook Page IDs for tracking specific competitors.
- `startUrls` - optional copied `facebook.com/ads/library/` URLs.
- `countryCode` - two-letter country filter.
- `activeStatus` - active ads or all statuses available for the selected category.
- `mediaType` - all, image, video, meme, or no-media ads.
- `dateFrom` - optional beginning of the ad-delivery period, inclusive, in `YYYY-MM-DD` format.
- `dateTo` - optional end of the ad-delivery period, inclusive, in `YYYY-MM-DD` format.
- `maxResults` - total unique rows across all sources.
- `requestDelayMillis` and `maxRetries` - advanced reliability controls.
- `proxyConfiguration` - advanced reliability settings. Keep the default for larger exports.

The prefilled input returns a non-empty Shopify sample and is suitable for testing the Actor.

### 🔍 Ready-made Meta Ads Library research tasks

Click any public Task example to start with a ready-made configuration for competitor tracking, ad-library research, lead-generation offer research, or creative inspiration.

| Research task                                                                                                                                    | Search mode              | Prefilled value               |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------ | ----------------------------- |
| [Extract Meta ads active in a date range](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/meta-ads-active-in-date-range)        | Keyword + delivery dates | `shopify`, July 1–23, 2026    |
| [Track Shopify Facebook ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/track-shopify-facebook-ads-by-page-id)             | Exact competitor Page ID | `20409006880`                 |
| [Find Facebook competitor ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/facebook-competitor-ads-by-keyword)              | Keyword discovery        | `project management software` |
| [Export ecommerce Meta ad creatives](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/ecommerce-meta-ad-creatives)               | Keyword discovery        | `shopify`                     |
| [Research SaaS Facebook and Instagram ad copy](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/instagram-saas-ad-copy-research) | Keyword discovery        | `ai customer support`         |
| [Find AI tool Facebook ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/ai-tools-facebook-ads)                              | Keyword discovery        | `ai video generator`          |
| [Research real estate Facebook ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/real-estate-facebook-ads)                   | Keyword discovery        | `homes for sale`              |
| [Research solar lead generation ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/solar-lead-generation-facebook-ads)        | Keyword discovery        | `solar panels`                |
| [Research roofing company Facebook ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/roofing-company-facebook-ads)           | Keyword discovery        | `roofing company`             |
| [Research dental implant Facebook ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/dental-implant-facebook-ads)             | Keyword discovery        | `dental implants`             |
| [Research personal injury lawyer ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/personal-injury-lawyer-facebook-ads)      | Keyword discovery        | `personal injury lawyer`      |
| [Research fitness app Instagram ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/fitness-app-instagram-ads)                 | Keyword discovery        | `fitness app`                 |
| [Research skincare Facebook ad creatives](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/skincare-facebook-ad-creatives)       | Keyword discovery        | `skincare`                    |
| [Research online course Facebook ads](https://apify.com/webdata_labs/meta-ads-library-scraper/examples/online-course-facebook-ads)               | Keyword discovery        | `online course`               |

For exact competitor monitoring, replace the Shopify example with any numeric Facebook Page ID. For market discovery, replace a keyword with your niche, product category, service, or customer problem.

The date fields select ads that **overlap the chosen delivery period**. An ad can therefore have a `startDate` earlier than `dateFrom` if it remained active during the selected period. You can use either boundary by itself, use both for a closed range, or leave both empty for no date restriction. When a copied Ads Library URL already contains dates, explicitly entered date fields take precedence.

### 📤 Output

```json
{
    "libraryId": "1234567890123456",
    "pageId": "123456789012345",
    "pageName": "Example Store",
    "isActive": true,
    "startDate": "2026-01-15T00:00:00.000Z",
    "bodyText": "Build your store and start selling today.",
    "headline": "Start your free trial",
    "ctaText": "Sign Up",
    "landingPageUrl": "https://example.com/offer",
    "creativeType": "image",
    "imageUrls": ["https://scontent.example.com/creative.jpg"],
    "publisherPlatforms": ["FACEBOOK", "INSTAGRAM"],
    "adUrl": "https://www.facebook.com/ads/library/?id=1234567890123456",
    "sourceValue": "example ecommerce",
    "countryCode": "US",
    "observedAt": "2026-07-23T12:00:00.000Z"
}
```

Every billable dataset row is a successfully parsed ad. Source failures and run counts are stored separately in the `OUTPUT` summary.

### 💵 How much does it cost to scrape Meta Ads Library?

The launch price is **$0.50 per 1,000 delivered ads** on Free and Bronze plans, with volume discounts for higher Apify plans. There is no Actor-start event. A 100-ad export costs about **$0.05** before plan discounts.

Apify platform usage is included in the pay-per-event price.

### ⚡ Tips for reliable runs

- Start with one precise advertiser or keyword before combining searches.
- Use a Facebook Page ID when you need one advertiser rather than keyword matches.
- Keep the default request delay unless you have a specific reason to change it.
- Creative CDN URLs can expire; download assets soon if you need durable copies.
- If a result looks incomplete, report it with a run URL and one non-secret query or Page ID.

### ⚠️ Limits and responsible use

- The Actor extracts only fields visible in Meta's public Ads Library.
- Spend, reach, impressions, demographics, and inactive history are not available for every ad category or country.
- Search totals and result order can change between runs.
- For ordinary commercial ads, Meta primarily exposes ads that are currently active. A past date range does not guarantee a complete archive of commercial ads that have since stopped.
- Dynamic creative may expose multiple text or media variants; arrays preserve those variants.

Meta Ads Library contains public advertising data, but laws and platform terms still apply. If your use involves personal data or regulated decisions, obtain appropriate legal advice.

### ❓ FAQ

#### Does it require a Facebook login or Meta developer token?

No. Enter a keyword, Facebook Page ID, or copied Ads Library URL and run the Actor.

#### Can it scrape one advertiser?

Yes. Supply the advertiser's numeric Facebook Page ID in `pageIds`, or paste a filtered Ads Library URL.

#### Can I schedule competitor-ad exports?

Yes. Save the input as an Apify Task and schedule it, or call the Actor through the Apify API.

#### Can I scrape ads from a specific date range?

Yes. Set **Ads active from**, **Ads active until**, or both. The boundaries are inclusive. An ad can have an earlier `startDate` if its delivery overlapped the selected period.

### 🛠️ Support

Open an issue from the Actor page and include the run URL, non-secret input, expected result, and one affected query or Page ID.

# Actor input Schema

## `searchQueries` (type: `array`):

Use keywords or advertiser names to discover competitors and ad ideas. Enter keywords here OR Facebook Page IDs below.

## `pageIds` (type: `array`):

Use numeric Facebook Page IDs to track ads from exact competitors. Enter Page IDs here OR search keywords above.

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

Optional copied facebook.com/ads/library search URLs. Their filters are preserved.

## `countryCode` (type: `string`):

Two-letter country code used for keyword and Page ID searches.

## `activeStatus` (type: `string`):

Return active ads or all statuses available for the selected ad category.

## `mediaType` (type: `string`):

Filter results by creative media type.

## `dateFrom` (type: `string`):

Optional. Beginning of the period in which ads should have been active. Ads may have started earlier. Leave both date fields empty to search without a date filter.

## `dateTo` (type: `string`):

Optional. End of the period in which ads should have been active. The boundary is inclusive.

## `maxResults` (type: `integer`):

Maximum number of unique ad rows across all supplied searches.

## `requestDelayMillis` (type: `integer`):

Advanced: delay in milliseconds between result-page requests.

## `maxRetries` (type: `integer`):

Advanced: maximum retry attempts for temporary request failures.

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

Residential proxy used for reliable larger exports. Keep the default unless you know what you are doing.

## Actor input object example

```json
{
  "searchQueries": [
    "shopify"
  ],
  "pageIds": [],
  "startUrls": [],
  "countryCode": "US",
  "activeStatus": "active",
  "mediaType": "all",
  "maxResults": 20,
  "requestDelayMillis": 1200,
  "maxRetries": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

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

Dataset containing one row per unique Meta Ads Library ad.

## `summary` (type: `string`):

Counts, failures, and transport diagnostics for this run.

# 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 = {
    "searchQueries": [
        "shopify"
    ],
    "countryCode": "US",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("webdata_labs/meta-ads-library-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 = {
    "searchQueries": ["shopify"],
    "countryCode": "US",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("webdata_labs/meta-ads-library-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 '{
  "searchQueries": [
    "shopify"
  ],
  "countryCode": "US",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call webdata_labs/meta-ads-library-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Meta Ads Library Scraper | 💵$0.5/1K",
        "description": "[💵 $0.50 / 1K] Track competitors by Facebook Page ID or discover ads by keyword and optional date range. Export public Meta, Facebook, and Instagram ads.",
        "version": "0.1",
        "x-build-id": "QzyjRDDiXTjhH6wAC"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/webdata_labs~meta-ads-library-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-webdata_labs-meta-ads-library-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/webdata_labs~meta-ads-library-scraper/runs": {
            "post": {
                "operationId": "runs-sync-webdata_labs-meta-ads-library-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/webdata_labs~meta-ads-library-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-webdata_labs-meta-ads-library-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": {
                    "searchQueries": {
                        "title": "Search keywords",
                        "type": "array",
                        "description": "Use keywords or advertiser names to discover competitors and ad ideas. Enter keywords here OR Facebook Page IDs below.",
                        "default": [
                            "shopify"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "pageIds": {
                        "title": "Specific competitor Facebook Page IDs",
                        "type": "array",
                        "description": "Use numeric Facebook Page IDs to track ads from exact competitors. Enter Page IDs here OR search keywords above.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "startUrls": {
                        "title": "Meta Ads Library URLs",
                        "type": "array",
                        "description": "Optional copied facebook.com/ads/library search URLs. Their filters are preserved.",
                        "default": [],
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "countryCode": {
                        "title": "Country",
                        "minLength": 2,
                        "maxLength": 2,
                        "type": "string",
                        "description": "Two-letter country code used for keyword and Page ID searches.",
                        "default": "US"
                    },
                    "activeStatus": {
                        "title": "Ad status",
                        "enum": [
                            "active",
                            "all"
                        ],
                        "type": "string",
                        "description": "Return active ads or all statuses available for the selected ad category.",
                        "default": "active"
                    },
                    "mediaType": {
                        "title": "Media type",
                        "enum": [
                            "all",
                            "image",
                            "video",
                            "meme",
                            "none"
                        ],
                        "type": "string",
                        "description": "Filter results by creative media type.",
                        "default": "all"
                    },
                    "dateFrom": {
                        "title": "Ads active from",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
                        "type": "string",
                        "description": "Optional. Beginning of the period in which ads should have been active. Ads may have started earlier. Leave both date fields empty to search without a date filter."
                    },
                    "dateTo": {
                        "title": "Ads active until",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
                        "type": "string",
                        "description": "Optional. End of the period in which ads should have been active. The boundary is inclusive."
                    },
                    "maxResults": {
                        "title": "Maximum ads",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of unique ad rows across all supplied searches.",
                        "default": 100
                    },
                    "requestDelayMillis": {
                        "title": "Delay between result pages",
                        "minimum": 0,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Advanced: delay in milliseconds between result-page requests.",
                        "default": 1200
                    },
                    "maxRetries": {
                        "title": "HTTP retries",
                        "minimum": 1,
                        "maximum": 6,
                        "type": "integer",
                        "description": "Advanced: maximum retry attempts for temporary request failures.",
                        "default": 3
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Residential proxy used for reliable larger exports. Keep the default unless you know what you are doing.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
