{ "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper", "description": "Scrape public Facebook Marketplace listings from keywords, search, category or listing links. No login or cookies. Get prices, photos, locations, condition, seller info, vehicle and property specs. Bulk runs and filters. JSON for price monitoring and resale leads.", "version": "1.0", "x-build-id": "rLycWHq6FOBT0mzMk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_wiki~facebook-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_wiki-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/data_wiki~facebook-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-data_wiki-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/data_wiki~facebook-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-data_wiki-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", "required": [ "urls" ], "properties": { "urls": { "title": "๐Ÿ”— Marketplace links or keywords", "type": "array", "description": "One entry per line. Marketplace search links, category links, single listing links (.../marketplace/item/ID), listing ids, or plain keywords such as iphone 13. Bulk input is supported.", "items": { "type": "string" } }, "location": { "title": "๐Ÿ“ Location", "type": "string", "description": "Applies to keywords, search links and category links. A city name used by Marketplace (nyc, london), a place such as Austin, TX, or coordinates as lat,lon. Leave empty to use the city in each link, or New York.", "default": "" }, "resultsLimit": { "title": "๐Ÿ“Š Maximum listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to save for each link or keyword, e.g. 10 with 2 inputs gives up to 20 listings. Use 0 for as many as Marketplace returns.", "default": 10 }, "includeListingDetails": { "title": "๐Ÿงพ Include listing details", "type": "boolean", "description": "Open every listing to add the description, all photos, condition, category, seller rating and join date, and vehicle or property specs. Slower, because each listing needs one extra request.", "default": true }, "minPrice": { "title": "๐Ÿ’ต Minimum price", "minimum": 0, "type": "number", "description": "Only listings priced at or above this amount. Leave empty for no minimum." }, "maxPrice": { "title": "๐Ÿ’ฐ Maximum price", "minimum": 0, "type": "number", "description": "Only listings priced at or below this amount. Leave empty for no maximum." }, "condition": { "title": "๐Ÿ”– Item condition", "type": "array", "description": "Only items in these conditions. Leave empty for any condition.", "items": { "type": "string", "enum": [ "new", "used_like_new", "used_good", "used_fair" ], "enumTitles": [ "New", "Used - like new", "Used - good", "Used - fair" ] }, "default": [] }, "listedWithin": { "title": "๐Ÿ•’ Listed within", "enum": [ "any", "24h", "7d", "30d" ], "type": "string", "description": "Only listings created within this period. Marketplace returns no listings when this is combined with price sorting; use Newest first or Best match instead.", "default": "any" }, "sortBy": { "title": "๐Ÿ”ƒ Sort by", "enum": [ "best_match", "newest", "price_low", "price_high", "distance" ], "type": "string", "description": "Order of the results.", "default": "best_match" }, "radiusKm": { "title": "๐Ÿ“ Search radius (km)", "minimum": 0, "type": "number", "description": "Distance from the location in kilometres. Marketplace may ignore it for logged-out visitors, so results can extend beyond it. Leave empty for the default." }, "delivery": { "title": "๐Ÿšš Delivery method", "enum": [ "any", "pickup", "shipping" ], "type": "string", "description": "Local pickup, shipping, or both.", "default": "any" }, "availability": { "title": "๐ŸŸข Availability", "enum": [ "any", "available", "sold" ], "type": "string", "description": "Show available items, sold items, or both.", "default": "any" }, "proxyConfiguration": { "title": "๐ŸŒ Proxy", "type": "object", "description": "Runs start without a proxy. If Facebook blocks the request, the Actor automatically switches to a datacenter proxy and then a residential proxy, and stays on it for the rest of the run.", "default": { "useApifyProxy": 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 } } } } } } } } } }