# Meta Brand Collaboration Scraper (`apify/brand-collaboration-scraper`) Actor

Extract branded content partnerships from Meta Ad Library. Get creators, brand partners, content types, dates, and links from Instagram and Facebook. Enrich with profile and post details. Export data, schedule runs via API, and integrate with other tools or AI workflows workflows.

- **URL**: https://apify.com/apify/brand-collaboration-scraper.md
- **Developed by:** [Apify](https://apify.com/apify) (Apify)
- **Categories:** Lead generation, Social media
- **Stats:** 7 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.40 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

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

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

### What is Brand Collaboration Scraper?

It's a powerful data extraction tool that allows you to **scrape brand collaboration partnerships on Instagram** from Meta Ad Library. To extract brand collaborations, just **find the creator or company name in "Branded Content" section, copy the URL, paste it into the Actor's input, and click "Save & Start" button**. With this branded content scraper API, you can:

🕵️ Find out which **Instagram creators your competitor brands are working with**

🦄 Scope the **official brand collabs an influencer** has had before committing

🤝 Get **key collaboration data**: creator, brand partner, content type, dates, and content links

🗂 Extract **brand collaboration content from Instagram** (and Facebook) at scale

⚡ Get **hundreds of collaborations for free** in minutes

🔓 **No login required** — and no Instagram or Facebook account needed

💾 Export branded content data in **JSON, CSV, Excel, or HTML**

🔗 Export via SDKs (Python & Node.js), use **API Endpoints**, webhooks, or integrate with apps & AI workflows

🔍 Explore other [**Instagram scraping tools**](https://apify.com/store/collections/instagram-scrapers) and [**Facebook scraping tools**](https://apify.com/store/collections/facebook-scrapers)

### What branded content data can I extract?

With this branded content API, you will be able to track influencer partnerships for any brand across two Meta platforms by getting data such as:

<table>
<tr>
<td>🏢 Brand collaboration company</td>
<td>🧑‍🎨 Creator name and profile URL</td>
</tr>
<tr>
<td>🎬 Content type: post/reel/story</td>
<td>📱 Platform (Instagram/Facebook)</td>
</tr>
<tr>
<td>🔗 Reel URL, Post URL, or Story URL</td>
<td>📅 Date released</td>
</tr>
<tr>
<td>🆔 Content ID</td>
<td></td>
</tr>
</table>

> Tip: If you need to scrape specific reels or posts, use 🎞️ [Instagram Reel Scraper](https://apify.com/apify/instagram-reel-scraper), 📝 [Instagram Post Scraper](https://apify.com/apify/instagram-post-scraper). If you need creators’ details, such as bio, number of followers, contacts, use 👤 [Instagram Profile Scraper](https://apify.com/apify/instagram-profile-scraper) for your next step.

### How do I use Brand Collaboration Scraper?

Brand Collaboration Scraper was designed to be easy to start with, even if you've never extracted data from the Meta Ad Library before. Here's how you can scrape branded content with this tool:

1. [Create](https://console.apify.com/sign-up) a free Apify account using your email.
2. Open [Brand Collaboration Scraper](https://apify.com/apify/brand-collaboration-scraper).
3. Head to the Meta Ad Library, [Branded Content](https://www.facebook.com/ads/library/branded_content/?source=fb-logo) tab.
4. Choose the platform, brand/creator time frame, then copy the resulting URL.
5. Go to the scraper, paste the URL, set result limit, and configure the date range if needed.
6. Click "Start" and wait for the data to be extracted.
7. Download your data in JSON, XML, CSV, Excel, or HTML.

### How much will scraping branded content cost you?

If you're on Apify Free plan, you will be able to scrape **800 reels, posts, and stories from brand-influencer collaborations** before needing to upgrade.

For more frequent or extensive branded content scraping, consider upgrading to the $29/month [Starter plan](https://apify.com/pricing), which would give you 5,800 results with a discount. And for scalable scraping, check out $199/month Scale or $999/month Business plan.

Check the [Pricing](https://apify.com/apify/brand-collaboration-scraper/pricing) tab for full cost tiers and discounts.

### ⬇️ Input

The input for Brand Collaboration Scraper should be a **Branded Content URL** such as `https://www.facebook.com/ads/library/branded_content/?query=Nike&target=instagram`. Just head over to the [Branded Content](https://www.facebook.com/ads/library/branded_content/) tab of Meta Ad Library, find the creator or company you're interested in, and copy the URL.

<a href="https://console.apify.com/actors/WHGjr2emdF9lMaefB/input">
<img src="https://raw.githubusercontent.com/apify-projects/actor-readme-images/ad6238ac1cc558f309cd5c97020ad5f0de407d2f/brand%20collaboration%20scraper_input.png" style="width:100%;"></a>

Once the URL was copied, paste it into Actor's input and choose the number of results per URL. You can also configure date filters to fetch the collabs only from the time range you're interested in.

<a href="https://console.apify.com/actors/WHGjr2emdF9lMaefB/input">
<img src="https://raw.githubusercontent.com/apify-projects/actor-readme-images/72587ebb00f630ab9d40d3e2630445e696593581/brand%20collaboration_input%202.png" style="width:70%;"></a>

Click on the [input tab](https://apify.com/apify/brand-collaboration-scraper/input-schema) for a full explanation of an input example in JSON.

### ⬆️ Output

The results will be wrapped into a dataset, which you can find in the **Output** tab.

<a href="https://console.apify.com/actors/WHGjr2emdF9lMaefB/input">
<img src="https://raw.githubusercontent.com/apify-projects/actor-readme-images/bb0db5a6737fbd42cbd1017a31e1aa5d83743f20/branded%20content_output.png" style="width:100%;"></a>

#### 🤝 **Extracted Instagram brand-influencer collaboration sample**

You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML. Here's what a typical output looks like:

```json
[
    {
        "id": "18574970662003190",
        "dateCreated": "2026-03-27",
        "creator": {
            "name": "oemerpa",
            "link": "https://www.instagram.com/_u/oemerpa"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "reel",
        "link": "https://www.instagram.com/reel/DWZOqqYgBf2/"
    },
    {
        "id": "18385286407088607",
        "dateCreated": "2026-03-26",
        "creator": {
            "name": "cfabastin",
            "link": "https://www.instagram.com/_u/cfabastin"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "post",
        "link": "https://www.instagram.com/p/DWW83ZjjiJz/"
    },
    {
        "id": "18151835719455788",
        "dateCreated": "2026-03-25",
        "creator": {
            "name": "cnnunderscored",
            "link": "https://www.instagram.com/_u/cnnunderscored"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "story",
        "link": "https://www.instagram.com/stories/cnnunderscored/3860808917572495903"
    },
    {
        "id": "18099180259802161",
        "dateCreated": "2026-03-25",
        "creator": {
            "name": "tatticassiano",
            "link": "https://www.instagram.com/_u/tatticassiano"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "reel",
        "link": "https://www.instagram.com/reel/DWTur8KgDx0/"
    },
    {
        "id": "18104260531909420",
        "dateCreated": "2026-03-24",
        "creator": {
            "name": "cfabastin",
            "link": "https://www.instagram.com/_u/cfabastin"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "reel",
        "link": "https://www.instagram.com/reel/DWRwZg7jv1Y/"
    },
    {
        "id": "17897801418263162",
        "dateCreated": "2026-03-20",
        "creator": {
            "name": "oemerpa",
            "link": "https://www.instagram.com/_u/oemerpa"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "reel",
        "link": "https://www.instagram.com/reel/DWG-YRvjAJu/"
    },
    {
        "id": "17976930447005728",
        "dateCreated": "2026-03-18",
        "creator": {
            "name": "peterfagnoni",
            "link": "https://www.instagram.com/_u/peterfagnoni"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "post",
        "link": "https://www.instagram.com/p/DWCQG8zDd-k/"
    },
    {
        "id": "18153744736450064",
        "dateCreated": "2026-03-12",
        "creator": {
            "name": "tatticassiano",
            "link": "https://www.instagram.com/_u/tatticassiano"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "reel",
        "link": "https://www.instagram.com/reel/DVy9LBTFSk2/"
    },
    {
        "id": "18042374495522387",
        "dateCreated": "2026-03-02",
        "creator": {
            "name": "peterfagnoni",
            "link": "https://www.instagram.com/_u/peterfagnoni"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "reel",
        "link": "https://www.instagram.com/reel/DVZG9V-jeZ3/"
    },
    {
        "id": "18162206230372183",
        "dateCreated": "2026-03-02",
        "creator": {
            "name": "rashwin99",
            "link": "https://www.instagram.com/_u/rashwin99"
        },
        "brandPartners": [
            {
                "name": "nike",
                "link": "https://www.instagram.com/_u/nike"
            }
        ],
        "type": "reel",
        "link": "https://www.instagram.com/reel/DVYnW-xElgo/"
    }
]
````

### Want to get other data from Instagram?

You can use any of the dedicated scrapers below if you want to scrape specific Instagram data. Each of them is built for a specific Instagram scraping use case. Feel free to browse them:

<table>
<tr>
<td>👤 <a href="https://apify.com/apify/instagram-profile-scraper">Instagram Profile Scraper</a></td>
<td>📝 <a href="https://apify.com/apify/instagram-post-scraper">Instagram Post Scraper</a></td>
<td>🛍️ <a href="https://apify.com/apify/facebook-ads-scraper">Instagram Ads Scraper</a></td>
</tr>
<tr>
<td>💬 <a href="https://apify.com/apify/instagram-comment-scraper">Instagram Comment Scraper</a></td>
<td>#️⃣ <a href="https://apify.com/apify/instagram-hashtag-scraper">Instagram Hashtag Scraper</a></td>
<td>👥 <a href="https://apify.com/apify/instagram-followers-scraper">Instagram Followers Scraper</a></td>
</tr>
<tr>
<td> 📸 <a href="https://apify.com/apify/instagram-scraper">Instagram Scraper</a></td>
<td>🎞 <a href="https://apify.com/apify/instagram-reel-scraper">Instagram Reel Scraper</a>
<td>🧲 <a href="https://apify.com/apify/social-media-leads-analyzer">Social Media Leads Analyzer</a></td>
</tr>
</table>

### ❓ FAQ

#### What is Meta branded content?

Branded Content is a dedicated section of the [Meta Ad Library](https://www.facebook.com/ads/library/branded_content/) that shows influencer partnerships — posts and reels created by content creators with an official paid partnership tag for a specific brand. The vast majority of branded content lives on Instagram, where creators partner with brands on sponsored posts and reels. This data is publicly available and can help you track competitor collaborations, discover influencer partnerships, and measure campaign reach.

#### How can Brand Collaboration Scraper help my business?

- **Competitor analysis**: See which Instagram creators your competitors are partnering with and how often.
- **Campaign tracking**: If you're the collaborating brand, easily track all branded content metrics across Instagram and Facebook in one place without manual searching.
- **Influencer discovery**: Find creators who are already working in your industry or niche on Instagram.
- **Performance benchmarking**: Compare collaboration frequency and content types across brands.

#### Can I export branded content data using API?

Yes, you can access the extracted branded content data through the Apify API. You'll need an Apify account and your API token (available under Integrations settings in Console). Apify API is organized around RESTful HTTP endpoints that enable you to manage, schedule, and run Apify actors. The API also lets you access any datasets, monitor actor performance, fetch results, create and update versions, and more. To access the API using Node.js, use the `apify-client` [NPM package](https://apify.com/apify/brand-collaboration-scraper/api/javascript). To access the API using Python, use the `apify-client` [PyPI package](https://apify.com/apify/brand-collaboration-scraper/api/python).

Click on the [API tab](https://apify.com/apify/brand-collaboration-scraper/api) for code examples or check out the [Apify API reference docs](https://docs.apify.com/api/v2) for full detail.

#### Can I use Brand Collaboration Scraper through an MCP server?

With Apify API, you can use Brand Collaboration Scraper within your AI workflows. You can connect to the [MCP server](https://apify.com/apify/brand-collaboration-scraper/api/mcp) using clients like ClaudeDesktop and LibreChat or build your own. Here's how you can set up Brand Collaboration Scraper via Model Context Protocol (MCP) server:

1. Start a Server-Sent Events (SSE) session to receive a `sessionId`.
2. Send API messages using that `sessionId` to trigger the scraper.
3. The message starts the Brand Collaboration Scraper with the provided input.
4. The response should be: `Accepted`.

This makes Brand Collaboration Scraper compatible with MCP server implementations and allows you to use it as a branded content API within your AI agent workflows.

#### Do I need proxies to scrape branded content?

You need proxies in general but you don't need to do anything extra to apply them if you run the scraper on the Apify platform. For successful branded content scraping, we run [residential proxies](https://apify.com/proxy?pricing=residential-ip#pricing) in the background which are included in Apify's monthly Starter plan **($29)**.

#### Can I integrate data from Brand Collaboration Scraper with other apps?

Yes. Brand Collaboration Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). You can integrate with Make, n8n, Zapier, ChatGPT, Slack, Airbyte, GitHub, Google Sheets, Asana, Google Drive, Keboola, MCP Servers, and more.

#### Is it legal to scrape branded content data?

Our scrapers are ethical and **do not extract any private user data**. Branded content data is publicly available through Meta's Ad Library, which Meta provides for transparency purposes. However, you should be aware that your results could contain personal data. You should not scrape personal data unless you have a legitimate reason to do so.

If you're unsure whether your reason is legitimate, consult your lawyers. You can also read our blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) and [ethical scraping](https://blog.apify.com/what-is-ethical-web-scraping-and-how-do-you-do-it/).

#### Brand Collaboration Scraper is not working?

We're always working on improving the performance of our Actors. So if you've got any technical feedback for Brand Collaboration Scraper or simply found a bug, please create an issue on the Actor's [Issues tab](https://apify.com/apify/brand-collaboration-scraper/issues/open).

# Actor input Schema

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

Head over to Meta Branded Content Library, set it up for platform, creator or brand, and copy the URL. You can add a list of URLs using the <b>Bulk edit</b> option.

## `resultsLimit` (type: `integer`):

Set the maximum number of results you want to scrape. If you set it to 5, you'll get 5 results for each input URL you've included. ⚠️ If you leave this field empty, you will get as many results as possible.

## `onlyPostsNewerThan` (type: `string`):

Scrape branded content from the provided date to the present day (or date set in 'Older than'). The date should be in YYYY-MM-DD absolute format or in relative format, e.g., 1 day, 2 months, 3 years. The JSON input also supports adding time units (UTC timezone): Full or partial ISO timestamp (e.g., `2025-09-23T10:02:01`) as absolute time and relative time, e.g., `1 hour` or `2 minutes`. If specified, it overrides the `start_date` query parameter of each input URL.

## `onlyPostsOlderThan` (type: `string`):

Scrape branded content from the provided date to the past (or date set in 'Newer than'). The date should be in YYYY-MM-DD or full ISO absolute format or in relative format e.g. 1 days, 2 months, 3 years. The JSON input also supports adding time units (UTC timezone): Full or partial ISO timestamp (e.g., `2025-09-23T10:02:01`) as absolute time and relative time, e.g., `1 hour` or `2 minutes`. If specified, it overrides the `end_date` query parameter of each input URL.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.facebook.com/ads/library/branded_content/?id=17841400602400210&query=Nike&target=instagram&end_date=2026-04-02&start_date=2026-02-01"
  ],
  "resultsLimit": 10,
  "onlyPostsNewerThan": "2024-01-01",
  "onlyPostsOlderThan": "2024-04-01"
}
```

# Actor output Schema

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

Dataset containing all scraped data

# 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": [
        "https://www.facebook.com/ads/library/branded_content/?id=17841400602400210&query=Nike&target=instagram&end_date=2026-04-02&start_date=2026-02-01"
    ],
    "resultsLimit": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("apify/brand-collaboration-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": ["https://www.facebook.com/ads/library/branded_content/?id=17841400602400210&query=Nike&target=instagram&end_date=2026-04-02&start_date=2026-02-01"],
    "resultsLimit": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("apify/brand-collaboration-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": [
    "https://www.facebook.com/ads/library/branded_content/?id=17841400602400210&query=Nike&target=instagram&end_date=2026-04-02&start_date=2026-02-01"
  ],
  "resultsLimit": 10
}' |
apify call apify/brand-collaboration-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Meta Brand Collaboration Scraper",
        "description": "Extract branded content partnerships from Meta Ad Library. Get creators, brand partners, content types, dates, and links from Instagram and Facebook. Enrich with profile and post details. Export data, schedule runs via API, and integrate with other tools or AI workflows workflows.",
        "version": "0.0",
        "x-build-id": "p5qmxj5fvItDdBoxm"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/apify~brand-collaboration-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-apify-brand-collaboration-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/apify~brand-collaboration-scraper/runs": {
            "post": {
                "operationId": "runs-sync-apify-brand-collaboration-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/apify~brand-collaboration-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-apify-brand-collaboration-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": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "📕 Branded Content URL",
                        "type": "array",
                        "description": "Head over to Meta Branded Content Library, set it up for platform, creator or brand, and copy the URL. You can add a list of URLs using the <b>Bulk edit</b> option.",
                        "items": {
                            "type": "string",
                            "pattern": "^(?=.*[?&]id=)(?=.*[?&]query=)(?=.*[?&]target=)(?=.*[?&]start_date=)(?=.*[?&]end_date=)https?://www\\.facebook\\.com/ads/library/branded_content/\\?.+$"
                        }
                    },
                    "resultsLimit": {
                        "title": "💯 Maximum posts/reels per URL",
                        "type": "integer",
                        "description": "Set the maximum number of results you want to scrape. If you set it to 5, you'll get 5 results for each input URL you've included. ⚠️ If you leave this field empty, you will get as many results as possible."
                    },
                    "onlyPostsNewerThan": {
                        "title": "Scrape content newer than",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$",
                        "type": "string",
                        "description": "Scrape branded content from the provided date to the present day (or date set in 'Older than'). The date should be in YYYY-MM-DD absolute format or in relative format, e.g., 1 day, 2 months, 3 years. The JSON input also supports adding time units (UTC timezone): Full or partial ISO timestamp (e.g., `2025-09-23T10:02:01`) as absolute time and relative time, e.g., `1 hour` or `2 minutes`. If specified, it overrides the `start_date` query parameter of each input URL."
                    },
                    "onlyPostsOlderThan": {
                        "title": "Scrape content older than",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$",
                        "type": "string",
                        "description": "Scrape branded content from the provided date to the past (or date set in 'Newer than'). The date should be in YYYY-MM-DD or full ISO absolute format or in relative format e.g. 1 days, 2 months, 3 years. The JSON input also supports adding time units (UTC timezone): Full or partial ISO timestamp (e.g., `2025-09-23T10:02:01`) as absolute time and relative time, e.g., `1 hour` or `2 minutes`. If specified, it overrides the `end_date` query parameter of each input URL."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
