{ "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper — No Login Required", "description": "Extract listings from Facebook Marketplace by location. No login or cookies needed. Supports geo-targeted search, category filtering, price range, and keyword search.", "version": "1.5", "x-build-id": "dUtog82F8g6KsDVrO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crowdpull~facebook-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crowdpull-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/crowdpull~facebook-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-crowdpull-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/crowdpull~facebook-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-crowdpull-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": { "marketplaceUrls": { "title": "🔗 Marketplace URLs", "type": "array", "description": "Named city Marketplace URLs, including city category/search pages. Direct numeric IDs and ZIP paths cannot be verified and fail validation. For those links, clear this field and use Location with city and country plus Search Query.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City or neighborhood name (e.g., 'Chicago', 'Southgate, MI', 'São Paulo'). Numeric ZIP paths are not used because Facebook can silently fall back to IP-geolocated results. Leave empty if using URLs above. Leave Marketplace URLs empty when using Location; supplying both fails validation." }, "searchQuery": { "title": "🔍 Search Query", "type": "string", "description": "Optional keyword search (e.g., 'furniture', 'iPhone 15', 'vintage'). Applied to the Location search or appended to URLs that don't already have a query." }, "maxListings": { "title": "📊 Max Listings", "minimum": -1, "type": "integer", "description": "Maximum number of listings to extract across all URLs. Set to -1 for unlimited.", "default": 100 }, "radiusKm": { "title": "📏 Search Radius (km)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Search radius in kilometers from the location center. Facebook default is ~65km.", "default": 65 }, "minPrice": { "title": "Minimum Price (cents)", "minimum": 0, "type": "integer", "description": "Minimum listing price in cents. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum Price (cents)", "minimum": 0, "type": "integer", "description": "Maximum listing price in cents. Leave empty for no maximum." }, "untilDate": { "title": "Until Date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only extract listings created on or after this date (YYYY-MM-DD). Older listings are skipped. Useful for monitoring — only get recent listings." }, "strictFiltering": { "title": "Strict Filtering", "type": "boolean", "description": "When enabled, excludes listings from locations that don't match the target city. Filters out broad matches and 'similar items' from nearby areas.", "default": false }, "includeDetails": { "title": "Include Listing Details", "type": "boolean", "description": "When enabled, fetches each listing's detail page for rich data: full description, all photos, vehicle make/model/odometer/colors, condition, and status. Adds ~1 second per listing. Charged as a separate 'listing-details' event.", "default": false }, "enableDedup": { "title": "Enable Smart Scrape (Dedup)", "type": "boolean", "description": "When enabled, listings scraped in previous runs are skipped. Only new listings are extracted.", "default": false }, "refreshWindowDays": { "title": "Refresh Window (days)", "minimum": 0, "maximum": 90, "type": "integer", "description": "Re-scrape listings first seen within the last N days to capture price changes. Set to 0 to never refresh.", "default": 0 }, "proxyConfig": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies recommended for Facebook.", "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 }, "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 } } } } } } } } } }