# Facebook Marketplace Scraper (`parseforge/facebook-marketplace-scraper`) Actor

Scrape public Facebook Marketplace listings by city and search term. Export titles, prices, images, seller names, categories, brands, vehicle specs, real-estate details and listing URLs. Pull thousands of listings across any location and download clean JSON, CSV or Excel files in minutes.

- **URL**: https://apify.com/parseforge/facebook-marketplace-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Social media, Lead generation, Marketing
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🛒 Facebook Marketplace Scraper

> 🚀 **Pull public Facebook Marketplace listings by city and search term.** Export titles, prices, categories, brands, vehicle specs, real-estate details, seller names and direct listing URLs into clean JSON, CSV or Excel.

> 🕒 **Last updated:** 2026-04-24 · **📊 29 fields** per listing · **🚗 Vehicle specs** · **🏡 Real-estate fields** · **🌆 City-based search**

The **Facebook Marketplace Scraper** queries Marketplace by city and keyword, paginates through the search feed, and returns each listing as a flat JSON record with 29 fields. The dataset covers titles, current price, currency, primary photo, seller name and id, category and subcategory, brand, condition, listing URL, delivery options, and typed blocks for vehicles (make, model, year, mileage, condition, transmission, fuel type) and real estate (bedrooms, bathrooms, square footage, property type).

The Actor classifies each listing into one of four types (general product, vehicle, rental or home-for-sale) based on the hydrated search feed plus title heuristics, so you can filter the output without post-processing. Vehicle fallback parses year, make and model from the title so older listings that don't expose structured vehicle fields still get typed.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Used-goods resellers, real-estate analysts, auto dealers, market researchers, price intelligence teams, data scientists | Price monitoring, inventory discovery, used-car pricing, rental market mapping, arbitrage detection, competitor listing analysis |

---

### 📋 What the Facebook Marketplace Scraper does

Five common workflows in a single run:

- 🛒 **City + keyword search.** Pass a city slug and a query, get the current Marketplace feed.
- 🚗 **Vehicle typed fields.** Year, make, model, mileage, condition, transmission and fuel when Facebook exposes them, with title-based fallbacks for the rest.
- 🏡 **Real-estate typed fields.** Bedrooms, bathrooms, square footage and property type for rentals and homes for sale.
- 🏷️ **Brand, category and delivery.** Structured category, subcategory, brand and delivery-option tags per listing.
- 🔗 **Direct listing URLs.** Every record includes the canonical marketplace URL for follow-up.

> 💡 **Why it matters:** Marketplace has no official export and no public search API. Scraper alternatives usually return 5-10 fields and break when Facebook changes class names. This Actor reads the hydration JSON behind the search page, so the schema is stable and the output is already typed.

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>searchQueries</code></td><td>array of objects</td><td>required*</td><td>Each object is <code>{ city: "nyc", query: "iphone" }</code>. City is the Marketplace URL slug.</td></tr>
<tr><td><code>startUrls</code></td><td>array of URLs</td><td>required*</td><td>Alternative: direct marketplace item URLs to scrape one by one.</td></tr>
<tr><td><code>maxItems</code></td><td>integer</td><td>10</td><td>Global cap on returned listings across all queries. Free plan tops out at 10.</td></tr>
<tr><td><code>enrichListings</code></td><td>boolean</td><td>true</td><td>Attempts detail-page enrichment when Facebook allows it. Falls back to search-feed metadata when detail pages require login.</td></tr>
<tr><td><code>proxyConfiguration</code></td><td>object</td><td>residential</td><td>Override the proxy group if you need a specific country.</td></tr>
</tbody>
</table>

\* Provide at least one of `searchQueries` or `startUrls`.

---

### 📊 Output

Every listing is returned as a flat JSON record with 29 fields.

#### 🧾 Key fields

<table>
<thead><tr><th>Field</th><th>Type</th><th>Description</th></tr></thead>
<tbody>
<tr><td><code>listingId</code></td><td>string</td><td>Stable Marketplace listing id.</td></tr>
<tr><td><code>title</code></td><td>string</td><td>Listing title.</td></tr>
<tr><td><code>price</code></td><td>number</td><td>Listed price as a number. Null for free items.</td></tr>
<tr><td><code>currency</code></td><td>string</td><td>ISO currency code when Facebook exposes it.</td></tr>
<tr><td><code>location</code></td><td>string</td><td>City name or region as displayed in the feed.</td></tr>
<tr><td><code>category</code></td><td>string</td><td>Marketplace category label.</td></tr>
<tr><td><code>subCategory</code></td><td>string</td><td>Deeper category label when available.</td></tr>
<tr><td><code>brand</code></td><td>string</td><td>Structured brand when Facebook exposes it.</td></tr>
<tr><td><code>listingType</code></td><td>string</td><td>One of <code>product</code>, <code>vehicle</code>, <code>rental</code>, <code>home-for-sale</code>.</td></tr>
<tr><td><code>url</code></td><td>string</td><td>Canonical marketplace URL.</td></tr>
<tr><td><code>images</code></td><td>array of strings</td><td>Image URLs.</td></tr>
<tr><td><code>sellerName</code></td><td>string</td><td>Seller display name.</td></tr>
<tr><td><code>sellerUrl</code></td><td>string</td><td>Seller profile URL.</td></tr>
<tr><td><code>condition</code></td><td>string</td><td>New, used-like-new, used-good and so on.</td></tr>
<tr><td><code>deliveryOptions</code></td><td>array of strings</td><td>Pickup, shipping or both.</td></tr>
<tr><td><code>vehicleMake</code></td><td>string</td><td>Manufacturer (vehicle listings).</td></tr>
<tr><td><code>vehicleModel</code></td><td>string</td><td>Model (vehicle listings).</td></tr>
<tr><td><code>vehicleYear</code></td><td>integer</td><td>Model year (vehicle listings).</td></tr>
<tr><td><code>vehicleMileage</code></td><td>integer</td><td>Odometer reading (vehicle listings).</td></tr>
<tr><td><code>vehicleCondition</code></td><td>string</td><td>Structured condition label.</td></tr>
<tr><td><code>transmission</code></td><td>string</td><td>Automatic, manual, etc.</td></tr>
<tr><td><code>fuelType</code></td><td>string</td><td>Gasoline, diesel, electric, hybrid.</td></tr>
<tr><td><code>bedrooms</code></td><td>integer</td><td>Bedroom count (rentals and homes).</td></tr>
<tr><td><code>bathrooms</code></td><td>number</td><td>Bathroom count (rentals and homes).</td></tr>
<tr><td><code>sqft</code></td><td>integer</td><td>Interior square footage.</td></tr>
<tr><td><code>propertyType</code></td><td>string</td><td>Apartment, house, condo, etc.</td></tr>
<tr><td><code>postedDate</code></td><td>ISO 8601</td><td>Creation timestamp when Facebook exposes it.</td></tr>
<tr><td><code>isAvailable</code></td><td>boolean</td><td>True when the listing is live and unsold.</td></tr>
<tr><td><code>scrapedAt</code></td><td>ISO 8601</td><td>Run timestamp.</td></tr>
</tbody>
</table>

#### 📦 Sample record

```json
{
  "listingId": "1065433001234567",
  "title": "2017 Honda Civic · LX Sedan 4D",
  "price": 12500,
  "currency": "USD",
  "location": "Los Angeles, CA",
  "category": "Vehicles",
  "subCategory": "Cars",
  "brand": "Honda",
  "listingType": "vehicle",
  "url": "https://www.facebook.com/marketplace/item/1065433001234567/",
  "images": ["https://scontent.fqfd1-1.fna.fbcdn.net/..."],
  "sellerName": "Juan Perez",
  "sellerUrl": "https://www.facebook.com/profile.php?id=100001...",
  "condition": "used-good",
  "deliveryOptions": ["pickup"],
  "vehicleMake": "Honda",
  "vehicleModel": "Civic",
  "vehicleYear": 2017,
  "vehicleMileage": 87500,
  "vehicleCondition": "used-good",
  "transmission": "automatic",
  "fuelType": "gasoline",
  "bedrooms": null,
  "bathrooms": null,
  "sqft": null,
  "propertyType": null,
  "postedDate": "2026-04-20T15:02:00.000Z",
  "isAvailable": true,
  "scrapedAt": "2026-04-24T12:00:00.000Z"
}
````

***

### ✨ Why choose this Actor

- **Typed categories.** Vehicle and real-estate listings come with structured fields so you can filter without regex.
- **29 fields per listing.** Most alternatives return title, price and an image. This one includes brand, condition, delivery, seller and postedDate.
- **Stable against redesigns.** Reads the hydration JSON rather than parsing DOM, so small UI tweaks don't break the output.
- **No tokens or accounts.** Anonymous access to public search feeds.
- **Ready for BI tools.** CSV and Excel export match your spreadsheet columns directly.

***

### 🚀 How to use

1. Pick a Marketplace city slug (e.g. `nyc`, `losangeles`, `miami`, `chicago`).
2. Add a search query per city in `searchQueries`.
3. Set `maxItems`, run the Actor, and download JSON, CSV or Excel.
4. Sort by `listingType` to split vehicles, rentals and general products.

***

### 🎯 Business Use Cases

- 📊 **Price Intelligence Teams** - Track pricing trends by brand, condition, and city to spot arbitrage opportunities across metros
- 🚗 **Auto Dealers** - Feed vehicle year, mileage, and price into depreciation models and benchmark against Kelley Blue Book or local dealer data
- 🏡 **Real Estate Analysts** - Map rental and for-sale inventory by neighborhood, track bedrooms and square footage pricing, and compare against MLS feeds
- 💼 **Resellers and Arbitrage** - Surface new listings in your category daily, filter by brand and condition, and route alerts when targets hit a price ceiling

***

### 🔌 Automating Facebook Marketplace Scraper

- Schedule runs per city so pricing and inventory stay current.
- Pipe results into Google Sheets, Airtable, Notion, BigQuery or a custom webhook.
- Fire alerts through Slack or email when a listing matches your target price.
- Call the Apify REST API for custom orchestration from your own backend.

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Urban planning and housing inventory studies
- Used-vehicle fleet tracking for transport research
- Reproducible research with cited, versioned dataset pulls
- Classroom exercises on market analysis and ethics

</td>
<td width="50%">

#### 🎨 Personal and creative

- Side projects, portfolio demos, and indie app launches
- Hobbyists tracking project car parts and fixtures
- Bargain hunters monitoring local listings for deals
- DIY restorers sourcing materials across markets

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Housing-justice analysis of rental pricing concentration
- Affordability reporting from informal rental inventory
- Investigative journalism on local commerce trends
- Community accountability databases with public listings

</td>
<td width="50%">

#### 🧪 Experimentation

- Train price-prediction and condition-classification models
- Validate product hypotheses against real listing data
- Prototype agent pipelines for inventory discovery
- Test dashboard concepts with live marketplace data

</td>
</tr>
</table>

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Facebook%20Marketplace%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Facebook%20Marketplace%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Facebook%20Marketplace%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Facebook%20Marketplace%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

**Which cities are supported?**
Every Marketplace city. Pass the slug Facebook uses in the URL (e.g. `nyc` for New York, `losangeles`, `miami`, `chicago`, `london`, `toronto`).

**Can I search by category rather than keyword?**
Use a category-style query (e.g. `cars for sale`, `apartment for rent`, `used furniture`). The Actor also classifies every listing into `product`, `vehicle`, `rental` or `home-for-sale` so you can filter downstream.

**Do I get seller contact info?**
Seller name and profile URL yes. Facebook does not expose phone numbers or emails for Marketplace sellers publicly.

**Why are some detail fields null?**
Facebook gates item detail pages behind login for anonymous traffic. The Actor falls back to the search-feed hydration data, which covers 29 fields reliably.

**Do I need a Facebook account?**
No. The Actor runs anonymously.

**How fresh is the data?**
Every run hits Marketplace live.

**Can I get historical pricing?**
Schedule runs and store the dataset yourself. We don't maintain a price history in the Actor.

**Does it support currencies other than USD?**
Yes. The `currency` field reflects whatever Facebook returns for each listing.

***

### 🔌 Integrate with any app

Works with [Make](https://apify.com/integrations), [Zapier](https://apify.com/integrations), [n8n](https://apify.com/integrations), [Slack](https://apify.com/integrations), [LangChain](https://apify.com/integrations), and [100+ other platforms](https://apify.com/integrations). The [Apify REST API](https://docs.apify.com/api/v2) is available for direct backend integration.

***

### 🔗 Recommended Actors

| Actor | What it does |
|---|---|
| [Facebook Comments Scraper](https://apify.com/parseforge/facebook-comments-scraper) | Pulls threaded comments, replies, reactions and mentions from any public Facebook post. |
| [Facebook Groups Scraper](https://apify.com/parseforge/facebook-groups-scraper) | Pulls member count, privacy, rules and admin info from public Facebook groups. |
| [Zillow Rentals Scraper](https://apify.com/parseforge/zillow-rentals-scraper) | Rental listings with price, beds, baths and history from Zillow. |
| [CarsForSale Scraper](https://apify.com/parseforge/carsforsale-com-scraper) | Inventory and pricing from CarsForSale.com. |
| [EquipmentTrader Scraper](https://apify.com/parseforge/equipmenttrader-com-scraper) | Heavy equipment listings with full specs and seller details. |

***

### 💡 Tips

- Run a small `maxItems` test first to confirm the city slug matches your target. Some cities use alternate spellings (e.g. `sanfrancisco`, not `san-francisco`).
- Use `listingType` as a downstream filter to split vehicles, rentals and general products before loading into your analytics tool.
- Schedule runs during off-peak hours. Marketplace refreshes its feed continuously, so evenings give the best new-inventory yield.

***

### 🆘 Support

Open a ticket at [tally.so/r/BzdKgA](https://tally.so/r/BzdKgA) and include the run id. Same-day replies on weekdays.

**New to Apify?** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) and your first run is on the house.

***

### ⚠️ Disclaimer

This Actor collects only publicly accessible Marketplace listings. You are responsible for complying with Facebook's Terms of Service, local data-protection laws (GDPR, CCPA) and any applicable commercial-use rules. Do not use scraped contact details to send unsolicited communications.

# Actor input Schema

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

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

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

List of { city, query } pairs. Example: { "city": "nyc", "query": "iphone" }. City can be a Facebook city slug like 'nyc', 'la', 'chicago', or 'newyork'.

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

Direct Facebook Marketplace listing URLs, e.g. https://www.facebook.com/marketplace/item/1234567890/

## `enrichListings` (type: `boolean`):

Fetch full listing details (images, description, seller) for each search result. Triggers listing-enrichment billing event on pay-per-event plans.

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

Residential proxies recommended for reliable extraction and to bypass Marketplace geo-gating.

## Actor input object example

```json
{
  "maxItems": 10,
  "searchQueries": [
    {
      "city": "nyc",
      "query": "iphone"
    }
  ],
  "enrichListings": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with scraped Facebook Marketplace listings

# 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 = {
    "maxItems": 10,
    "searchQueries": [
        {
            "city": "nyc",
            "query": "iphone"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/facebook-marketplace-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 = {
    "maxItems": 10,
    "searchQueries": [{
            "city": "nyc",
            "query": "iphone",
        }],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/facebook-marketplace-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 '{
  "maxItems": 10,
  "searchQueries": [
    {
      "city": "nyc",
      "query": "iphone"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call parseforge/facebook-marketplace-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Facebook Marketplace Scraper",
        "description": "Scrape public Facebook Marketplace listings by city and search term. Export titles, prices, images, seller names, categories, brands, vehicle specs, real-estate details and listing URLs. Pull thousands of listings across any location and download clean JSON, CSV or Excel files in minutes.",
        "version": "1.0",
        "x-build-id": "9WKH5EN37N9yzQVqU"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~facebook-marketplace-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-facebook-marketplace-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/parseforge~facebook-marketplace-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-facebook-marketplace-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/parseforge~facebook-marketplace-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-facebook-marketplace-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": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "searchQueries": {
                        "title": "Search Queries",
                        "type": "array",
                        "description": "List of { city, query } pairs. Example: { \"city\": \"nyc\", \"query\": \"iphone\" }. City can be a Facebook city slug like 'nyc', 'la', 'chicago', or 'newyork'."
                    },
                    "startUrls": {
                        "title": "Listing URLs",
                        "type": "array",
                        "description": "Direct Facebook Marketplace listing URLs, e.g. https://www.facebook.com/marketplace/item/1234567890/",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "enrichListings": {
                        "title": "Enrich Listings",
                        "type": "boolean",
                        "description": "Fetch full listing details (images, description, seller) for each search result. Triggers listing-enrichment billing event on pay-per-event plans.",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Residential proxies recommended for reliable extraction and to bypass Marketplace geo-gating."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```