{ "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper by City: Prices, Dates & New Items", "description": "For flippers, resellers and price research: Facebook Marketplace listings for any keyword near any city you type, with title, price, currency, listing date, photo and link. A 6-city run on 2026-10-12 returned 592 listings, every one dated. Watch mode returns only new listings. No login.", "version": "0.1", "x-build-id": "0glsQWqFoivIG063G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~facebook-marketplace-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-facebook-marketplace-monitor", "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/neverempty~facebook-marketplace-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-facebook-marketplace-monitor", "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/neverempty~facebook-marketplace-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-facebook-marketplace-monitor", "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 terms", "type": "array", "description": "What to search for, one term per line, as you would type it in the Marketplace search box (for example bike, iphone 15, sofa). Each term is searched near each location. Leave empty only if you paste search URLs below.", "items": { "type": "string" } }, "locations": { "title": "Locations (city or latitude,longitude)", "type": "array", "description": "Where to search, one per line: a city such as Austin, TX or London, UK or Tokyo, or a latitude,longitude pair such as 40.71,-74.00. Works in any country. Each row shows the place that was searched.", "items": { "type": "string" } }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 500, "type": "integer", "description": "How far from the location to search, in kilometres (1 to 500). Empty uses 65 km, the same as the Marketplace search page." }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest price to return, in the local currency of the location (dollars, pounds, yen and so on). Empty means no lower limit." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest price to return, in the local currency of the location. Empty means no upper limit." }, "condition": { "title": "Item condition", "type": "array", "description": "Return only items in these conditions, as the seller marked them. 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" ] } }, "daysSinceListed": { "title": "Listed within", "enum": [ "1", "7", "30" ], "type": "string", "description": "Return only items listed in the last 1, 7 or 30 days. Empty means any time." }, "sortBy": { "title": "Sort by", "enum": [ "newest", "relevance", "price_low", "price_high", "distance" ], "type": "string", "description": "Order of the results. Empty uses newest first, which is also what watch mode needs." }, "searchUrls": { "title": "Marketplace search URLs", "type": "array", "description": "Optional. Paste the address of a Marketplace search page, for example https://www.facebook.com/marketplace/nyc/search/?query=bike&maxPrice=300. The filters in the URL are used as they are.", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max listings per search", "minimum": 1, "maximum": 300, "type": "integer", "description": "Most listings to return for each search (1 to 300). Empty uses 50. In watch mode this caps the new listings returned per run; the rest come in the next run." }, "onlyNew": { "title": "Watch mode: only new listings and price changes", "type": "boolean", "description": "On: the first run remembers what is listed now, and later runs return only listings posted since then and price changes. Off: return the current results every time.", "default": false }, "includePriceChanges": { "title": "Watch mode: include price changes", "type": "boolean", "description": "In watch mode, also return listings whose price changed since the last check, with the previous price. Off returns only new listings.", "default": true }, "watchPages": { "title": "Watch mode: pages to check", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many result pages (about 24 listings each) watch mode reads on each run (1 to 15). Empty uses 5." }, "watchName": { "title": "Watch name", "type": "string", "description": "Optional label that keeps separate memories for the same search, for example one per schedule. Letters, digits, dot, dash and underscore." }, "resetMonitoringState": { "title": "Watch mode: start over", "type": "boolean", "description": "On: forget what this watch remembered and start again from the current listings.", "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 } } } } } } } } } }