{
"openapi": "3.0.1",
"info": {
"title": "Facebook Marketplace Scraper - No Login",
"description": "Scrape Facebook Marketplace listings by keyword and city, or from any Marketplace URL. No login, no cookies. Price, title, location, photo, listing date, and optional description, all photos, condition and coordinates. Pay per listing.",
"version": "0.1",
"x-build-id": "8d2LBewIxc2TnYH1s"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/leadproof~facebook-marketplace/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-leadproof-facebook-marketplace",
"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/leadproof~facebook-marketplace/runs": {
"post": {
"operationId": "runs-sync-leadproof-facebook-marketplace",
"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/leadproof~facebook-marketplace/run-sync": {
"post": {
"operationId": "run-sync-leadproof-facebook-marketplace",
"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": "What to search for, one keyword or phrase per line (for example \"iphone 15\" or \"sofa\"). Each keyword is searched in every location below. Leave empty to scrape the newest listings of each location.",
"items": {
"type": "string"
}
},
"locations": {
"title": "Locations",
"type": "array",
"description": "Marketplace locations, one per line: the city name exactly as it appears in the Marketplace URL (facebook.com/marketplace/nyc, la, london, telaviv) or the numeric location ID from that URL. Defaults to nyc when keywords are set.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Marketplace URLs",
"type": "array",
"description": "Optional. Paste Marketplace search, category or city URLs straight from your browser, with any filters already applied (for example https://www.facebook.com/marketplace/telaviv/vehicles/). Filters set below are not added to these URLs.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxItems": {
"title": "Max listings per search",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "How many listings to collect for each keyword-and-location pair and each URL. You are charged per listing returned. Facebook may end a feed earlier.",
"default": 50
},
"includeDetails": {
"title": "Include listing details",
"type": "boolean",
"description": "Also open each listing to add its description, all photos, condition, exact coordinates, location text and currency. Slower and uses more proxy traffic.",
"default": false
},
"minPrice": {
"title": "Minimum price",
"minimum": 0,
"type": "integer",
"description": "Optional. In the local currency of the location."
},
"maxPrice": {
"title": "Maximum price",
"minimum": 0,
"type": "integer",
"description": "Optional. In the local currency of the location."
},
"daysSinceListed": {
"title": "Listed within",
"enum": [
"",
"1",
"7",
"30"
],
"type": "string",
"description": "Only listings posted in this period.",
"default": ""
},
"sortBy": {
"title": "Sort by",
"enum": [
"best_match",
"newest",
"price_low",
"price_high"
],
"type": "string",
"description": "Order of the results. Facebook picks the most relevant listings for your keywords; the actor then orders them by date or price.",
"default": "best_match"
},
"itemCondition": {
"title": "Condition",
"type": "array",
"description": "Optional. Keep only these conditions. Empty means any condition.",
"items": {
"type": "string",
"enum": [
"new",
"used_like_new",
"used_good",
"used_fair"
],
"enumTitles": [
"New",
"Used - like new",
"Used - good",
"Used - fair"
]
}
},
"radiusKm": {
"title": "Radius (km)",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Optional. Search radius around the location, in kilometres. Facebook's default is about 65 km."
},
"countryCode": {
"title": "Proxy country",
"type": "string",
"description": "Two-letter country code for the residential proxy exit. The location in the search decides which listings you get; a matching country is optional but can help.",
"default": "US"
},
"proxy": {
"title": "Proxy tier",
"enum": [
"RESIDENTIAL",
"DATACENTER",
"NONE"
],
"type": "string",
"description": "RESIDENTIAL is the reliable choice for Facebook. DATACENTER is cheaper but is usually sent to the login page. NONE runs without a proxy.",
"default": "RESIDENTIAL"
},
"delayMs": {
"title": "Delay between requests (ms)",
"minimum": 0,
"type": "integer",
"description": "Pause between feed pages and item pages, plus a small random jitter.",
"default": 1500
},
"navTimeoutMs": {
"title": "Navigation timeout (ms)",
"type": "integer",
"description": "How long one page load may take before it is retried.",
"default": 45000
},
"keepDebugHtml": {
"title": "Save a debug snapshot",
"type": "boolean",
"description": "Stores the first search page's HTML in the key-value store for troubleshooting.",
"default": false
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}