{ "openapi": "3.0.1", "info": { "title": "Facebook Marketplace [$1.5💰] Get newest items ASAP", "description": "💰$1.50/1K Facebook Marketplace scraper with no cookies or login — anti-bot handled and maintained so your pipeline doesn't die mid-contract. Keyword or URL search, price/condition/radius filters; cars include make, model, odometer & VIN. $1.50/1k flat — a per-result price you can quote to clients.", "version": "0.0", "x-build-id": "9reEBqychhpUDrtCp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~facebook-marketplace-scraper-ppe/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-facebook-marketplace-scraper-ppe", "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/memo23~facebook-marketplace-scraper-ppe/runs": { "post": { "operationId": "runs-sync-memo23-facebook-marketplace-scraper-ppe", "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/memo23~facebook-marketplace-scraper-ppe/run-sync": { "post": { "operationId": "run-sync-memo23-facebook-marketplace-scraper-ppe", "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": { "startUrls": { "title": "URLs of the Marketplace search pages to scrape", "type": "array", "description": "Paste one or more Facebook Marketplace URLs such as `'https://www.facebook.com/marketplace/nyc/search/?query=sleeper%20trucks'`.", "items": { "type": "string" } }, "searchQuery": { "title": "Keyword to search", "type": "string", "description": "Search term to use when building a Marketplace search URL." }, "sortBy": { "title": "Sort By", "enum": [ "best_match", "creation_time_descend", "price_ascend", "price_descend", "distance_ascend" ], "type": "string", "description": "Sort order used when building the Marketplace search.", "default": "best_match" }, "daysSinceListed": { "title": "Days Since Listed", "enum": [ "0", "1", "7", "30" ], "type": "string", "description": "Preset age filter matching the reference repo. Keeps only listings posted within the last N days: `\"0\"` = any time (default), `\"1\"` = last 24 hours, `\"7\"` = last 7 days, `\"30\"` = last 30 days.", "default": "0" }, "availability": { "title": "Availability", "enum": [ "in stock", "out of stock" ], "type": "string", "description": "Availability filter used when building the Marketplace search.", "default": "in stock" }, "deliveryMethod": { "title": "Delivery", "enum": [ "all", "local_pick_up", "shipping" ], "type": "string", "description": "Delivery filter used when building the Marketplace search.", "default": "all" }, "conditionNew": { "title": "Condition: New", "type": "boolean", "description": "Include new items in the generated Marketplace URL.", "default": false }, "conditionUsedLikeNew": { "title": "Condition: Used - like new", "type": "boolean", "description": "Include used-like-new items in the generated Marketplace URL.", "default": false }, "conditionUsedGood": { "title": "Condition: Used - good", "type": "boolean", "description": "Include used-good items in the generated Marketplace URL.", "default": false }, "conditionUsedFair": { "title": "Condition: Used - fair", "type": "boolean", "description": "Include used-fair items in the generated Marketplace URL.", "default": false }, "minPrice": { "title": "Min. Price", "type": "integer", "description": "Minimum listing price for the generated Marketplace URL.", "default": 0 }, "maxPrice": { "title": "Max. Price", "type": "integer", "description": "Maximum listing price for the generated Marketplace URL.", "default": 0 }, "countryPreset": { "title": "Country preset", "enum": [ "", "usa", "usa_full", "can", "mex", "bra", "arg", "aus", "nzl", "ind", "gbr", "fra", "spa" ], "type": "string", "description": "Optional nationwide preset based on the reference repo. When selected, the actor generates multiple Marketplace URLs that cover the chosen country. Leave this empty to use a single Marketplace location below.", "default": "" }, "marketplaceLocation": { "title": "Marketplace location", "type": "string", "description": "Marketplace location slug such as `phoenix`, `nyc`, `prague`, or `melbourne`. This is used for a single generated URL when no country preset is selected." }, "radiusKm": { "title": "Search radius (km)", "type": "integer", "description": "Search radius in kilometers for the generated Marketplace URL.", "default": 200 }, "exact": { "title": "Exact search", "type": "boolean", "description": "If checked, Facebook will try to match the search query more exactly when the generated URL is used.", "default": false }, "categories": { "title": "Categories", "type": "array", "description": "Pick one or more Facebook Marketplace categories. Each selected category is scraped as its own search (Facebook only accepts one category per search), and the results are combined. Leave empty to search all categories. If you also use a Country preset, every city is searched for every selected category.", "items": { "type": "string", "enum": [ "vehicles", "propertyforsale", "propertyrentals", "apparel", "electronics", "entertainment", "family", "free", "garden", "hobbies", "home", "instruments", "pets", "sports", "toys", "classifieds" ], "enumTitles": [ "Vehicles", "Home Sales (Property for sale)", "Property Rentals", "Apparel", "Electronics", "Entertainment", "Family", "Free Stuff", "Garden & Outdoor", "Hobbies", "Home Goods", "Musical Instruments", "Pet Supplies", "Sporting Goods", "Toys & Games", "Classifieds" ] } }, "categoryId": { "title": "Category ID (advanced)", "type": "string", "description": "Advanced: raw Facebook Marketplace category slug(s) to append as `category_id`. Prefer the Categories picker above. You can list several slugs comma-separated (e.g. `vehicles,electronics`) and each is scraped as its own search. Use category slugs like `vehicles` or `propertyforsale`, not numeric IDs." }, "latitude": { "title": "Latitude", "type": "number", "description": "Optional latitude for precise pinned-location searches. Provide longitude too." }, "longitude": { "title": "Longitude", "type": "number", "description": "Optional longitude for precise pinned-location searches. Provide latitude too." }, "includeSeller": { "title": "Include Seller data and more details about the item", "type": "boolean", "description": "If checked, the scraper will try to open the item page and scrape more data about the item. Adds the full description, all photos, structured attributes, and (for vehicles) the complete `vehicle` field set. Note: the seller's name/profile is only served by Facebook to logged-in sessions — provide `cookies` to get it; without cookies `seller` stays null but `vehicle.sellerType` is still returned. Default: false (faster, search-results-only runs).", "default": false }, "flattenOutput": { "title": "Flatten output for easier use", "type": "boolean", "description": "If checked, the actor will export a cleaner, flatter dataset with top-level fields like title, description, location, and pricing. Leave it off to keep the current response format for existing integrations.", "default": false }, "monitoringMode": { "title": "Run in monitoring mode where only newly items compared to previous runs will be scraped", "type": "boolean", "description": "If checked, it will only scrape newly items compared to what has been scraped in previous runs.", "default": false }, "resetMonitoringCache": { "title": "Reset monitoring cache before this run", "type": "boolean", "description": "If checked, the actor will wipe the monitoring-mode cache (the named key-value store `facebook-marketplace-default-filter-ppe`) at the start of this run. All currently-live listings will then be treated as new and pushed to the dataset. Use this once when switching from testing to production, then turn it off so subsequent runs only return genuinely new items. Has no effect when `monitoringMode` is off.", "default": false }, "preciseLocation": { "title": "Precise location filtering", "type": "boolean", "description": "If checked, the scraper will enforce strict geo-filtering. It will use latitude/longitude from the URL (e.g. &latitude=39.04&longitude=-77.49&radius=65) instead of coordinates inferred by Facebook from the proxy IP. Results whose location falls outside the requested radius will be discarded. Recommended when Facebook redirects away from the city slug and returns listings from the wrong region.", "default": false }, "locationResultsMode": { "title": "How should location be handled?", "enum": [ "maximize_results", "mark_far_results", "only_nearby_results" ], "type": "string", "description": "Choose whether to keep as many Facebook results as possible, keep them but mark far-away ones, or only keep listings that fall inside the resolved search radius after checking item detail pages.", "default": "maximize_results" }, "cookies": { "title": "Cookies", "type": "array", "description": "Optional Facebook cookies exported from a browser extension such as EditThisCookie. If provided, the actor will sanitize and reuse them for both URL-based searches and filter-generated searches." }, "maxItems": { "title": "Maximum items per crawl", "type": "integer", "description": "Maximum number of items that will be scraped per crawl.", "default": 100 }, "minDelay": { "title": "Min delay for API call", "type": "integer", "description": "Minimum delay in seconds between Facebook API calls. Lower = faster and cheaper runs; raise it if you see rate-limiting on very large runs.", "default": 2 }, "maxDelay": { "title": "Max delay for API call", "type": "integer", "description": "Maximum delay in seconds between Facebook API calls. Lower = faster and cheaper runs; raise it if you see rate-limiting on very large runs.", "default": 5 }, "maxConcurrency": { "title": "Max Concurrency", "type": "integer", "description": "Maximum number of pages that can be processed at the same time.", "default": 10 }, "minConcurrency": { "title": "Min Concurrency", "type": "integer", "description": "Minimum number of pages that will be processed at the same time.", "default": 1 }, "maxRequestRetries": { "title": "Max Request Retries", "type": "integer", "description": "Number of times the crawler will retry a failed request before giving up. Keep this low (5-10) so a single deterministic error cannot burn the entire run timeout on retries.", "default": 10 }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies." } } }, "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 } } } } } } } } } }