{ "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper: Price Trend Checker", "description": "Scrape listings from Facebook Marketplace with the Facebook Marketplace Scraper. Extract item titles, prices, descriptions, seller info, images, and locations. Perfect for market research, price tracking, and competitor analysis. Fast, accurate, and scalable for bulk listings.", "version": "0.1", "x-build-id": "etWpBbkWij9HTlvni" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~facebook-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-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/scrapier~facebook-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-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/scrapier~facebook-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-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": { "priceWatchUrls": { "title": "๐Ÿ”Ž Price-watch URLs", "type": "array", "description": "One or more Facebook Marketplace search URLs to put on price watch. Each URL is scanned page by page for listings and their price signals. Example: https://www.facebook.com/marketplace/108479165840750/search/?query=iphone โ€” combine several queries, cities or categories to widen the watch.", "items": { "type": "string" } }, "listingsToScan": { "title": "๐Ÿ“‰ Listings to scan per URL", "minimum": 0, "type": "integer", "description": "How many listings to scan per URL before the deal filters are applied. Use 0 for no cap (scan everything found). Example: 100 scans up to 100 listings, then only the ones matching your deal filters are saved. Defaults to 20." }, "fetchFullDetail": { "title": "๐Ÿงพ Fetch full listing detail", "type": "boolean", "description": "ON: open each listing page for full detail (description, attributes, photos) alongside the price data โ€” slower but richer. OFF: use only the fields present in the search results โ€” faster. Discount signals are available in both modes. Defaults to on." }, "minPrice": { "title": "๐Ÿ’ต Minimum price", "minimum": 0, "type": "integer", "description": "Only keep listings priced at or above this amount. Leave empty for no lower bound. Example: minPrice=50 drops anything under 50. Listings without a readable price are skipped when a price band is set." }, "maxPrice": { "title": "๐Ÿท๏ธ Maximum price", "minimum": 0, "type": "integer", "description": "Only keep listings priced at or below this amount. Leave empty for no upper bound. Example: minPrice=50 + maxPrice=300 keeps listings priced 50-300." }, "currency": { "title": "๐Ÿ’ฑ Currency filter", "type": "string", "description": "Only keep listings in this ISO currency code (case-insensitive). Leave empty to accept any currency. Example: currency=USD keeps only US-dollar listings." }, "onlyDiscounted": { "title": "๐Ÿ”ฅ Only discounted listings", "type": "boolean", "description": "ON: keep only listings that show a genuine price drop - a strikethrough / was-price higher than the current price, or a higher comparable price. Nothing is fabricated: only Facebook's own signals count. OFF: keep all listings. Default is false.", "default": false }, "proxyConfiguration": { "title": "๐ŸŒ Proxy", "type": "object", "description": "Optional Apify Proxy preferences. The actor always runs Marketplace requests through residential IPs with a guest-session warmup and fresh-IP retry, so this is only advisory." } } }, "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 } } } } } } } } } }