# Marketplace Arbitrage Radar, Local Resale Deal Intelligence (`scrapemint/facebook-marketplace-deal-finder`) Actor
Scan Facebook Marketplace for resale arbitrage opportunities. Input keyword plus city. Returns price, distance, location, condition, posted date, seller, and direct listing URL for every match. Built for resellers, flippers, and retail arbitrage operators. Pay per listing.
- **URL**: https://apify.com/scrapemint/facebook-marketplace-deal-finder.md
- **Developed by:** [Kennedy Mutisya](https://apify.com/scrapemint) (community)
- **Categories:** E-commerce, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage
## 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
## Marketplace Arbitrage Radar — Local Resale Deal Intelligence
Scan Facebook Marketplace for resale arbitrage opportunities. Every row carries title, price, original price (if marked down), condition, location, distance, posted date, seller, image, and direct listing URL. Inputs: keywords plus city slugs. Built for eBay and Amazon resellers, flippers, retail arbitrage operators, and local commerce researchers. Pay per listing.
**Ranks for:** Facebook Marketplace scraper, Marketplace deal finder, resale arbitrage tool, eBay flipping research, retail arbitrage data, FB Marketplace API, Marketplace alert system, local resale intelligence.
---
### How it works
```mermaid
flowchart LR
A[Keyword + city slugs] --> B[Marketplace search page]
B --> C[Intercept GraphQL
marketplace_search response]
C --> D[Filter by price,
condition, age]
D --> E[JSON listing rows]
````
The actor opens each search URL in a real Chromium with your Facebook session cookies, then captures the GraphQL response that powers the Marketplace UI. Listings are deduped by listing ID across runs so the same item does not show up twice.
***
### Why you need cookies
Facebook Marketplace blocks anonymous traffic. Every public scraper that claims to work without login is either fragile, illegal, or returns nothing. This actor takes the same approach Apify's category leader does: you paste your own session cookies once, the actor uses them for the run, and they never leave the run.
The minimum cookies needed are `c_user`, `xs`, and `datr`. Use a Cookie Editor extension to export them from a logged in browser tab.
***
### Who uses this
| Role | Use case |
|---|---|
| **eBay reseller** | Daily sweeps for under priced electronics, sneakers, lego sets in a 25 mile radius. |
| **Retail arbitrage** | Catch new old stock and damaged box items priced below clearance. |
| **Furniture flipper** | Watch for distressed mid century pieces under 200 USD across multiple metros. |
| **Local commerce analyst** | Build price benchmark datasets for specific brands and models. |
| **Insurance ops** | Track stolen merch reappearing on Marketplace by serial number or distinctive tag. |
***
### Quick start
**Sweep iPhones in San Francisco:**
```json
{
"keywords": ["iphone"],
"cities": ["sanfrancisco"],
"minPrice": 100,
"maxPrice": 600,
"fbCookies": [{ "name": "c_user", "value": "...", "domain": ".facebook.com" }]
}
```
**Multi metro Lego deal sweep:**
```json
{
"keywords": ["lego star wars", "lego technic"],
"cities": ["sanfrancisco", "losangeles", "newyork", "chicago"],
"maxPrice": 200,
"daysListed": 3
}
```
**Used like new tools only:**
```json
{
"keywords": ["dewalt drill", "milwaukee impact"],
"cities": ["austin"],
"condition": "used_like_new",
"maxItemsPerSearch": 50
}
```
***
### Sample output
```json
{
"id": "1023456789012345",
"url": "https://www.facebook.com/marketplace/item/1023456789012345/",
"title": "iPhone 14 Pro 256GB Unlocked",
"price": 580,
"currency": "USD",
"originalPrice": 700,
"isMarkedDown": true,
"condition": "used_like_new",
"category": "Cell Phones",
"city": "sanfrancisco",
"location": "San Francisco, CA",
"distanceMiles": 4.2,
"postedAt": "2026-05-03T18:14:22.000Z",
"postedDaysAgo": 1,
"seller": {
"id": "100012345678901",
"name": "John D.",
"profileUrl": "https://www.facebook.com/100012345678901"
},
"primaryImageUrl": "https://scontent.fsfo3-1.fna.fbcdn.net/...",
"imageUrls": [
"https://scontent.fsfo3-1.fna.fbcdn.net/...",
"https://scontent.fsfo3-1.fna.fbcdn.net/..."
],
"isShippingAvailable": true,
"deliveryTypes": ["local_pickup", "shipping"],
"search": "iphone",
"scrapedAt": "2026-05-04T13:45:00.000Z"
}
```
***
### Filters
| Field | Effect |
|---|---|
| `minPrice`, `maxPrice` | Drop listings outside the price band. 0 means no bound. |
| `daysListed` | Keep only listings posted within the last N days. Use 1 for fresh only. |
| `condition` | Restrict to one condition tier. Resellers usually want `used_like_new` or `used_good`. |
| `maxItemsPerSearch` | Cap per (keyword, city) pair. Default 25. |
| `maxItemsTotal` | Hard cost cap across all searches. Default 100. |
***
### Schedule it
Run hourly to catch fresh listings. Dedupe is on by default so the same listing does not push twice across runs. Pair with the Apify webhook integration to push new listings into Slack, Discord, or a Sheets pricing dashboard the moment they land.
```mermaid
flowchart LR
A[Cron every 60 min] --> B[Run actor with
watch list]
B --> C{New listings
under price floor?}
C -- Yes --> D[Webhook to Slack
or your CRM]
C -- No --> E[Sleep]
```
***
### Pricing
The first 30 listings per run are free. After that, $0.005 per listing pushed.
***
### FAQ
#### Do I really need to paste my Facebook cookies?
Yes. Marketplace returns 400 to anonymous requests. Every working Marketplace scraper on the Apify store, including the category leader, uses cookie based auth.
#### Will my Facebook account get banned?
Cookie based scraping with residential proxies and conservative scroll passes has not historically caused bans for browsing only flows. We do not log in, comment, message sellers, or click reactions. That said, you assume the risk.
#### What is a city slug?
It is the part of the FB Marketplace URL between `/marketplace/` and `/search`. For example, `https://www.facebook.com/marketplace/sanfrancisco/search` has slug `sanfrancisco`. Other examples: `newyork`, `losangeles`, `chicago`, `austin`, `london`, `toronto`.
#### Can I scan an entire country?
No. Facebook only exposes city scoped Marketplace search. To cover a country, list the major metros as cities. Most resellers care about 5 to 10 metros anyway.
#### How fresh is the data?
Real time. Each run hits the live search page so you see the same listings the public site shows.
#### What if Facebook rotates the GraphQL shape?
The actor walks the response tree looking for any node that has both a `listing_price` and a `marketplace_listing_title` field. If Facebook renames those, the parser will need a small patch. We monitor and update.
#### Can I run this on a schedule?
Yes. Use the Apify scheduler. Hourly catches new listings as they post. Daily is fine for slower categories like furniture.
#### What happens if my cookies expire?
Facebook session cookies last weeks to months. The actor returns a clear error if it gets redirected to login. Re paste fresh cookies and rerun.
***
### Related actors
- **Amazon Product Scraper** — Amazon listing pricing and metadata for cross referencing flips
- **Amazon Review Intelligence** — Amazon review analysis for product validation
- **Ecommerce Scraper** — generic Shopify, WooCommerce, BigCommerce product extraction
- **Zillow Home Price Scraper** — local housing comp data for market context
- **Yelp Review Intelligence** — local business reputation data
# Actor input Schema
## `keywords` (type: `array`):
Search queries. Each one runs against every city you list. Examples: 'iphone', 'lego star wars', 'dewalt drill'.
## `cities` (type: `array`):
Facebook Marketplace city slugs. The slug is the part of the URL between /marketplace/ and /search. Examples: sanfrancisco, newyork, losangeles, london, austin. Default uses sanfrancisco if left empty.
## `minPrice` (type: `integer`):
Drop listings below this price. 0 keeps everything.
## `maxPrice` (type: `integer`):
Drop listings above this price. 0 keeps everything.
## `daysListed` (type: `integer`):
Drop listings older than this. 0 keeps everything. Use 1 to focus on fresh deals only.
## `condition` (type: `string`):
Restrict to a condition. 'any' returns everything.
## `maxItemsPerSearch` (type: `integer`):
Cap on listings returned per (keyword, city) pair.
## `maxItemsTotal` (type: `integer`):
Hard cap across all searches. Controls total cost.
## `scrollPasses` (type: `integer`):
How many times to scroll each search page to load more results. Each pass typically loads another batch via GraphQL.
## `dedupe` (type: `boolean`):
Skip listing IDs already pushed in previous runs. Turn off to track price changes on the same listing over time.
## `fbCookies` (type: `array`):
Required. Paste your Facebook cookies from a logged in browser. Format: array of {name, value, domain}. The minimum needed are c\_user, xs, and datr. Use the EditThisCookie or Cookie-Editor browser extension to export them. Cookies stay inside this run only.
## `proxyConfiguration` (type: `object`):
Apify proxy. Residential is strongly recommended; Facebook flags datacenter ranges aggressively.
## Actor input object example
```json
{
"keywords": [
"iphone"
],
"cities": [
"sanfrancisco"
],
"minPrice": 0,
"maxPrice": 0,
"daysListed": 0,
"condition": "any",
"maxItemsPerSearch": 25,
"maxItemsTotal": 100,
"scrollPasses": 3,
"dedupe": true,
"fbCookies": [],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"keywords": [
"iphone"
],
"cities": [
"sanfrancisco"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapemint/facebook-marketplace-deal-finder").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"keywords": ["iphone"],
"cities": ["sanfrancisco"],
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("scrapemint/facebook-marketplace-deal-finder").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 '{
"keywords": [
"iphone"
],
"cities": [
"sanfrancisco"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call scrapemint/facebook-marketplace-deal-finder --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapemint/facebook-marketplace-deal-finder",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Marketplace Arbitrage Radar, Local Resale Deal Intelligence",
"description": "Scan Facebook Marketplace for resale arbitrage opportunities. Input keyword plus city. Returns price, distance, location, condition, posted date, seller, and direct listing URL for every match. Built for resellers, flippers, and retail arbitrage operators. Pay per listing.",
"version": "0.1",
"x-build-id": "a9h02LY0Nnma22ZR3"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapemint~facebook-marketplace-deal-finder/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapemint-facebook-marketplace-deal-finder",
"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/scrapemint~facebook-marketplace-deal-finder/runs": {
"post": {
"operationId": "runs-sync-scrapemint-facebook-marketplace-deal-finder",
"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/scrapemint~facebook-marketplace-deal-finder/run-sync": {
"post": {
"operationId": "run-sync-scrapemint-facebook-marketplace-deal-finder",
"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": {
"keywords": {
"title": "Keywords to search",
"type": "array",
"description": "Search queries. Each one runs against every city you list. Examples: 'iphone', 'lego star wars', 'dewalt drill'.",
"default": [],
"items": {
"type": "string"
}
},
"cities": {
"title": "City slugs",
"type": "array",
"description": "Facebook Marketplace city slugs. The slug is the part of the URL between /marketplace/ and /search. Examples: sanfrancisco, newyork, losangeles, london, austin. Default uses sanfrancisco if left empty.",
"default": [],
"items": {
"type": "string"
}
},
"minPrice": {
"title": "Minimum price (USD)",
"minimum": 0,
"maximum": 1000000,
"type": "integer",
"description": "Drop listings below this price. 0 keeps everything.",
"default": 0
},
"maxPrice": {
"title": "Maximum price (USD)",
"minimum": 0,
"maximum": 1000000,
"type": "integer",
"description": "Drop listings above this price. 0 keeps everything.",
"default": 0
},
"daysListed": {
"title": "Posted within last N days",
"minimum": 0,
"maximum": 365,
"type": "integer",
"description": "Drop listings older than this. 0 keeps everything. Use 1 to focus on fresh deals only.",
"default": 0
},
"condition": {
"title": "Condition filter",
"enum": [
"any",
"new",
"used_like_new",
"used_good",
"used_fair"
],
"type": "string",
"description": "Restrict to a condition. 'any' returns everything.",
"default": "any"
},
"maxItemsPerSearch": {
"title": "Max listings per keyword and city",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Cap on listings returned per (keyword, city) pair.",
"default": 25
},
"maxItemsTotal": {
"title": "Max listings per run",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Hard cap across all searches. Controls total cost.",
"default": 100
},
"scrollPasses": {
"title": "Scroll passes",
"minimum": 0,
"maximum": 30,
"type": "integer",
"description": "How many times to scroll each search page to load more results. Each pass typically loads another batch via GraphQL.",
"default": 3
},
"dedupe": {
"title": "Deduplicate across runs",
"type": "boolean",
"description": "Skip listing IDs already pushed in previous runs. Turn off to track price changes on the same listing over time.",
"default": true
},
"fbCookies": {
"title": "Facebook session cookies",
"type": "array",
"description": "Required. Paste your Facebook cookies from a logged in browser. Format: array of {name, value, domain}. The minimum needed are c_user, xs, and datr. Use the EditThisCookie or Cookie-Editor browser extension to export them. Cookies stay inside this run only.",
"default": []
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify proxy. Residential is strongly recommended; Facebook flags datacenter ranges aggressively.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```