# Facebook Posts Search Scraper (`scrapier/facebook-posts-search-scraper`) Actor

🔎 Facebook Posts Search Scraper extracts public Facebook posts by keywords or hashtags—capturing text, author, date, URL, reactions, shares, comments & media. 📊 Ideal for social listening, brand monitoring, trend analysis & market research. ⚡ Fast, reliable CSV/JSON export.

- **URL**: https://apify.com/scrapier/facebook-posts-search-scraper.md
- **Developed by:** [Scrapier](https://apify.com/scrapier) (community)
- **Categories:** Automation, Lead generation, Social media
- **Stats:** 4 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

### Facebook Posts Search Scraper

The Facebook Posts Search Scraper is a fast, reliable Facebook posts extractor that discovers and collects public posts by keywords or hashtags. It solves the manual work of sifting through Facebook search results by automating discovery and extraction of post text, author/page metadata, and engagement stats. Built for marketers, developers, data analysts, and researchers, this Facebook post search scraper helps you scrape Facebook posts by keyword at scale and export clean data for analysis.

### What data / output can you get?

Use this Facebook posts search tool to extract structured fields from public posts discovered via search. Results are stored in an Apify dataset for easy export to JSON or CSV.

| Data field | Description | Example value |
| --- | --- | --- |
| facebookUrl | Page or profile URL associated with the post | https://www.facebook.com/FCBarcelona |
| pageId | Numeric ID of the page/profile (if detected) | "6592350000" |
| pageName | Page/profile name (if detected) | "FC Barcelona" |
| postId | Post/reel/video identifier | "123456789012345" |
| url | Canonical permalink to the post (if available) | "https://www.facebook.com/FCBarcelona/posts/123456789012345" |
| time | Human-readable timestamp derived from Unix time | "2024-04-25 14:32:10" |
| timestamp | Unix timestamp (seconds) | 1714055530 |
| likes | Reaction count parsed from page JSON | 15234 |
| comments | Comment count parsed from page JSON | 1287 |
| shares | Share count parsed from page JSON (0 if missing) | 543 |
| text | Post text content (truncated to ~5,000 chars) | "Matchday photos and highlights from Camp Nou..." |
| searchQuery | The keyword that discovered this post | "football" |

Bonus fields in the dataset include:
- facebookId (often equals pageId when available)
- postFacebookId (alias of postId)
- topLevelUrl (original URL visited)
- link (alias of url)
- thumb (image/thumbnail URL when detected)

Exports: Download results from the Apify dataset as JSON or CSV.

### Key features

- 🔍 Powerful keyword-based discovery
  - Search-driven Facebook posts crawler that finds public posts by topic or hashtag and parses post pages for structured data.
- 📈 Batch scraping & bulk automation
  - Provide multiple searchQueries to process in one run. The actor handles concurrent searches and collects up to your maxPosts per query.
- ⏱️ Flexible time filtering
  - Filter results by recency with postTimeRange options: 24h, 7d, 30d, 90d (or all time by default).
- 🔁 Resilient fetching with retries
  - Robust HTTP fetching with 3 retries and backoff to reduce transient failures and improve stability.
- 🌐 Proxy support
  - Works great out of the box with Apify Proxy (prefilled). Dedicated proxy is used for search discovery to improve reliability.
- 💾 Clean, structured outputs
  - Consistent fields for page info, post IDs, timestamps, engagement metrics, and text content. Easy CSV/JSON export from the Apify dataset.
- 🐍 Built on Python + Apify
  - A developer-friendly Facebook posts extractor built with aiohttp and Apify SDK for predictable, production-ready runs.

### How to use Facebook Posts Search Scraper - step by step

1. Sign in to Apify and open the Apify Console.
2. Go to Actors and select “facebook-posts-search-scraper”.
3. Add your input:
   - searchQueries: a list of keywords/hashtags (e.g., ["football", "cricket"]).
   - maxPosts: how many posts to collect per keyword (1–5000).
   - postTimeRange: "", "24h", "7d", "30d", or "90d".
   - proxyConfiguration: leave as prefilled (Apify Proxy) or customize.
4. Click Start to run the actor.
5. During the run, the tool discovers Facebook search results for each query and extracts post pages.
6. When finished, go to the OUTPUT tab to view your dataset.
7. Export your results as JSON or CSV for analysis.

Pro tip: Use multiple specific searchQueries (including branded terms or topic phrases) to improve match quality for your Facebook search results scraper workflow.

### Use cases

| Use case | Description |
| --- | --- |
| Social listening & trend tracking | Monitor public conversations and engagement around topics by using this Facebook public posts scraper for ongoing keyword tracking. |
| Brand monitoring | Collect public posts that mention your brand or products to analyze sentiment and engagement. |
| Content research | Discover posts with high reactions/comments to inspire content ideas using a Facebook post history scraper approach. |
| Market & competitor research | Track competitor pages/posts and engagement metrics via a Facebook page posts scraper workflow. |
| Hashtag analysis | Explore public posts around industry or campaign hashtags with a Facebook hashtag posts scraper. |
| Academic & policy research | Build datasets of public discourse for analysis using a Facebook posts data scraper that exports structured JSON/CSV. |
| Automation pipelines | Feed clean post data into analytics or dashboards as part of a Facebook posts crawler pipeline. |

### Why choose Facebook Posts Search Scraper?

A precise, automation-ready Facebook posts extractor focused on reliability and clean output.

- 🎯 Accuracy-first parsing: Extracts IDs, timestamps, engagement counts, and text from post page HTML/embedded JSON.
- ⚡ Scales by query: Handle multiple keywords in one run and set maxPosts up to 5,000 per query for bulk discovery.
- 🔁 Built-in resilience: Timeouts and 3-retry logic reduce flaky failures common with social platforms.
- 🌐 Smart proxy usage: Uses Apify Proxy for discovery and supports custom proxy configuration for post fetches.
- 🧩 Structured outputs: Consistent fields for easy downstream analysis and CSV/JSON exports.
- 🛡️ Public-only focus: Designed for public content; no login or private data access.
- 🏗️ Production-ready: Python + Apify infrastructure for dependable scraping beyond browser extensions or unstable scripts.

### Is it legal / ethical to use Facebook Posts Search Scraper?

Yes—when used responsibly. This tool targets publicly available Facebook content and does not access private or authenticated data.

Guidelines for compliant use:
- Only collect and use publicly available information.
- Do not scrape private profiles or content behind authentication.
- Follow Facebook’s terms and applicable data protection regulations.
- Consult your legal counsel for edge cases or regulated use.

### Input parameters & output format

Example JSON input
```json
{
  "searchQueries": ["football", "cricket"],
  "maxPosts": 50,
  "postTimeRange": "7d",
  "proxyConfiguration": { "useApifyProxy": true }
}
````

Input fields

- searchQueries (array)
  - Description: Enter topics/keywords to explore. Each keyword runs as a separate search.
  - Default: \[""]
  - Required: No
- maxPosts (integer)
  - Description: How many posts to collect per keyword. Range: 1 → 5,000. Default: 50.
  - Default: 50
  - Required: No
- postTimeRange (string)
  - Description: Filter by recency. Allowed values: "", "24h", "7d", "30d", "90d" ("" = all time).
  - Default: ""
  - Required: No
- proxyConfiguration (object)
  - Description: Proxy configuration. Works great out of the box—Apify Proxy enabled by default (prefill).
  - Default: (prefill) { "useApifyProxy": true }
  - Required: No

Example JSON output

```json
{
  "facebookUrl": "https://www.facebook.com/FCBarcelona",
  "pageId": "6592350000",
  "pageName": "FC Barcelona",
  "facebookId": "6592350000",
  "postId": "123456789012345",
  "postFacebookId": "123456789012345",
  "url": "https://www.facebook.com/FCBarcelona/posts/123456789012345",
  "topLevelUrl": "https://www.facebook.com/FCBarcelona/posts/123456789012345",
  "time": "2024-04-25 14:32:10",
  "timestamp": 1714055530,
  "likes": 15234,
  "comments": 1287,
  "shares": 543,
  "text": "Matchday photos and highlights from Camp Nou...",
  "link": "https://www.facebook.com/FCBarcelona/posts/123456789012345",
  "thumb": "https://scontent.xx.fbcdn.net/v/t1.6435-9/...",
  "searchQuery": "football"
}
```

Notes:

- Some fields may be null if not present on the page (e.g., pageName, pageId, thumb).
- shares defaults to 0 when not explicitly found.
- link mirrors url when the canonical permalink is detected.

### FAQ

#### Do I need to log in to Facebook?

✅ No. The scraper targets publicly available posts and does not require login or cookies. It collects public content only.

#### Can it scrape by keyword or hashtag?

✅ Yes. Provide topics or hashtags in searchQueries to discover public posts that match your queries using this Facebook post scraper and Facebook hashtag posts scraper approach.

#### What engagement data does it collect?

✅ It captures reaction counts (likes), comments count, and shares count from public post pages. Comment text is not collected—only counts.

#### How many posts can I scrape per keyword?

📈 You can set maxPosts from 1 up to 5,000 per query. The actor processes multiple searchQueries in one run for bulk coverage.

#### Does it filter by time range?

✅ Yes. Use postTimeRange with "", "24h", "7d", "30d", or "90d" to filter posts by recency ("" = all time).

#### What formats can I export to?

💾 Results are stored in an Apify dataset. You can download your data as JSON or CSV from the OUTPUT tab.

#### How does proxying work?

🌐 The actor works well with Apify Proxy (prefilled). It also uses a dedicated proxy for search discovery. You can customize proxyConfiguration if needed.

#### What kinds of Facebook posts are supported?

🧭 The tool discovers and processes public Facebook content found through search (e.g., page posts, videos, reels). Extraction is based on the post page HTML/embedded JSON.

### Closing CTA / Final thoughts

The Facebook Posts Search Scraper is built to automate discovery and extraction of public Facebook posts at scale. It delivers clean post IDs, timestamps, engagement metrics, and text so marketers, analysts, researchers, and developers can act on insights faster.

Set your keywords, choose a time range, and export structured results to JSON or CSV. Developers can integrate the Apify dataset output into pipelines or analytics stacks with ease. Start extracting smarter with a reliable, search-driven Facebook posts crawler today.

### What are other Facebook scraping tools?

If you want to scrape specific Facebook data, you can use any of the dedicated scrapers below for faster and more targeted results.

| Scraper Name | Scraper Name |
|---|---|
| [Facebook Ads Library Scraper](https://apify.com/scrapier/facebook-ads-library-scraper) | [Facebook Page Email Scraper](https://apify.com/scrapier/facebook-page-email-scraper) |
| [Facebook B2b Email Scraper](https://apify.com/scrapier/facebook-b2b-email-scraper) | [Facebook Page Lead Scraper](https://apify.com/scrapier/facebook-page-lead-scraper) |
| [Facebook B2b Lead Scraper](https://apify.com/scrapier/facebook-b2b-lead-scraper) | [Facebook Page Phone Number Scraper](https://apify.com/scrapier/facebook-page-phone-number-scraper) |
| [Facebook B2b Phone Number Scraper](https://apify.com/scrapier/facebook-b2b-phone-number-scraper) | [Facebook Page Posts Scraper](https://apify.com/scrapier/facebook-page-posts-scraper) |
| [Facebook Comments Scraper](https://apify.com/scrapier/facebook-comments-scraper) | [Facebook Page Scraper](https://apify.com/scrapier/facebook-page-scraper) |
| [Facebook Email Scraper](https://apify.com/scrapier/facebook-email-scraper) | [Facebook Pages Scraper](https://apify.com/scrapier/facebook-pages-scraper) |
| [Facebook Event Search Scraper](https://apify.com/scrapier/facebook-event-search-scraper) | [Facebook Phone Number Scraper](https://apify.com/scrapier/facebook-phone-number-scraper) |
| [Facebook Events Scraper](https://apify.com/scrapier/facebook-events-scraper) | [Facebook Photos Scraper](https://apify.com/scrapier/facebook-photos-scraper) |
| [Facebook Followers Following Scraper](https://apify.com/scrapier/facebook-followers-following-scraper) | [Facebook Posts Scraper](https://apify.com/scrapier/facebook-posts-scraper) |
| [Facebook Followers Scraper](https://apify.com/scrapier/facebook-followers-scraper) | [Facebook Profile Email Scraper](https://apify.com/scrapier/facebook-profile-email-scraper) |
| [Facebook Group Member Scraper](https://apify.com/scrapier/facebook-group-member-scraper) | [Facebook Profile Lead Scraper](https://apify.com/scrapier/facebook-profile-lead-scraper) |
| [Facebook Group Post Scraper](https://apify.com/scrapier/facebook-group-post-scraper) | [Facebook Profile Phone Number Scraper](https://apify.com/scrapier/facebook-profile-phone-number-scraper) |
| [Facebook Group Posts And Details Scraper](https://apify.com/scrapier/facebook-group-posts-and-details-scraper) | [Facebook Reels Scraper](https://apify.com/scrapier/facebook-reels-scraper) |
| [Facebook Group Profile Scraper](https://apify.com/scrapier/facebook-group-profile-scraper) | [Facebook Reviews Scraper](https://apify.com/scrapier/facebook-reviews-scraper) |
| [Facebook Groups Posts Scraper](https://apify.com/scrapier/facebook-groups-posts-scraper) | [Facebook Search Scraper](https://apify.com/scrapier/facebook-search-scraper) |
| [Facebook Groups Scraper](https://apify.com/scrapier/Facebook-Groups-Scraper) | [Facebook Url To Id Scraper](https://apify.com/scrapier/facebook-url-to-id-scraper) |
| [Facebook Groups Search Scraper](https://apify.com/scrapier/facebook-groups-search-scraper) | [Facebook User Search Scraper](https://apify.com/scrapier/Facebook-User-Search-Scraper) |
| [Facebook Lead Scraper](https://apify.com/scrapier/facebook-lead-scraper) | [Facebook Video Search Scraper](https://apify.com/scrapier/facebook-video-search-scraper) |
| [Facebook Likes Reactions Scraper](https://apify.com/scrapier/facebook-likes-reactions-scraper) | [Facebook Video Transcript Extractor](https://apify.com/scrapier/facebook-video-transcript-extractor) |
| [Facebook Marketplace Scraper](https://apify.com/scrapier/facebook-marketplace-scraper) | [Facebook Videos Scraper](https://apify.com/scrapier/facebook-videos-scraper) |

# Actor input Schema

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 Enter topics you want to explore!

Examples: football • cricket • tech news • recipes • travel

🎯 Each keyword = a separate search → more posts discovered

## `maxPosts` (type: `integer`):

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📈 How many posts to collect per keyword?

🎚️ Range: 1 → 5,000 posts
💯 Default: 50 (quick runs)
🚀 Need more? Crank it up to 5000!

## `postTimeRange` (type: `string`):

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📅 Filter by recency—get only fresh content!

⏳ All time (default) • 24h • 7d • 30d • 90d

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛡️ Proxy configuration

💫 Works great out of the box—Apify Proxy enabled by default!
⚙️ Adjust only when you need custom setup.

## Actor input object example

```json
{
  "searchQueries": [
    "football"
  ],
  "maxPosts": 50,
  "postTimeRange": "",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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": [
        "football"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapier/facebook-posts-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["football"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapier/facebook-posts-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "football"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scrapier/facebook-posts-search-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Facebook Posts Search Scraper",
        "description": "🔎 Facebook Posts Search Scraper extracts public Facebook posts by keywords or hashtags—capturing text, author, date, URL, reactions, shares, comments & media. 📊 Ideal for social listening, brand monitoring, trend analysis & market research. ⚡ Fast, reliable CSV/JSON export.",
        "version": "0.1",
        "x-build-id": "e22CbwxC6e1iNe9bA"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapier~facebook-posts-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapier-facebook-posts-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scrapier~facebook-posts-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapier-facebook-posts-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scrapier~facebook-posts-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapier-facebook-posts-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchQueries": {
                        "title": "🔑 Search Keywords",
                        "type": "array",
                        "description": "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n💡 Enter topics you want to explore!\n\nExamples: football • cricket • tech news • recipes • travel\n\n🎯 Each keyword = a separate search → more posts discovered",
                        "default": [
                            ""
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxPosts": {
                        "title": "📊 Max Posts per Query",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n📈 How many posts to collect per keyword?\n\n🎚️ Range: 1 → 5,000 posts\n💯 Default: 50 (quick runs)\n🚀 Need more? Crank it up to 5000!",
                        "default": 50
                    },
                    "postTimeRange": {
                        "title": "⏱️ Time Filter",
                        "enum": [
                            "",
                            "24h",
                            "7d",
                            "30d",
                            "90d"
                        ],
                        "type": "string",
                        "description": "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n📅 Filter by recency—get only fresh content!\n\n⏳ All time (default) • 24h • 7d • 30d • 90d",
                        "default": ""
                    },
                    "proxyConfiguration": {
                        "title": "🌐 Proxy Settings",
                        "type": "object",
                        "description": "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n🛡️ Proxy configuration\n\n💫 Works great out of the box—Apify Proxy enabled by default!\n⚙️ Adjust only when you need custom setup."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```