{ "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Deals Scraper", "description": "Find deals on Facebook Marketplace automatically: monitor whole categories (Vehicles, Furniture, Free, Tools + more) or keywords in any city, newest listings first with price filters. No Facebook login. Export JSON, CSV, Excel, or automate via API and schedules.", "version": "0.1", "x-build-id": "I5NMPgDy99ycvoQ4G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/flipper_ai~fb-marketplace-deals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-flipper_ai-fb-marketplace-deals-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/flipper_ai~fb-marketplace-deals-scraper/runs": { "post": { "operationId": "runs-sync-flipper_ai-fb-marketplace-deals-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/flipper_ai~fb-marketplace-deals-scraper/run-sync": { "post": { "operationId": "run-sync-flipper_ai-fb-marketplace-deals-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "What to search for on Marketplace. Ignored when Category browse is selected.", "items": { "type": "string" } }, "category": { "title": "Category browse", "enum": [ "", "vehicles", "motorcycles", "boats", "propertyrentals", "apparel", "electronics", "entertainment", "family", "free", "garden", "home-improvements", "instruments", "office-supplies", "pets", "sports", "toys", "video-games", "antiques", "appliances", "furniture", "tools" ], "type": "string", "description": "Optional. Browse a whole Marketplace category instead of keyword search. If search queries are also set, the queries win and this category is ignored (Facebook can't combine them) — a warning appears in the log and run status.", "default": "" }, "location": { "title": "Location (major city)", "enum": [ "Albuquerque, NM", "Anchorage, AK", "Atlanta, GA", "Austin, TX", "Baltimore, MD", "Baton Rouge, LA", "Birmingham, AL", "Boise, ID", "Boston, MA", "Buffalo, NY", "Calgary, AB", "Charleston, SC", "Charlotte, NC", "Chicago, IL", "Cincinnati, OH", "Cleveland, OH", "Colorado Springs, CO", "Columbus, OH", "Dallas, TX", "Denver, CO", "Des Moines, IA", "Detroit, MI", "Edmonton, AB", "El Paso, TX", "Fort Worth, TX", "Fresno, CA", "Grand Rapids, MI", "Halifax, NS", "Hamilton, ON", "Honolulu, HI", "Houston, TX", "Huntsville, AL", "Indianapolis, IN", "Jacksonville, FL", "Kansas City, MO", "Knoxville, TN", "Las Vegas, NV", "Lexington, KY", "Little Rock, AR", "Los Angeles, CA", "Louisville, KY", "Madison, WI", "Memphis, TN", "Miami, FL", "Milwaukee, WI", "Minneapolis, MN", "Montreal, QC", "Nashville, TN", "New Orleans, LA", "New York, NY", "Oakland, CA", "Omaha, NE", "Orlando, FL", "Ottawa, ON", "Panama City, FL", "Pensacola, FL", "Philadelphia, PA", "Phoenix, AZ", "Pittsburgh, PA", "Portland, OR", "Providence, RI", "Raleigh, NC", "Richmond, VA", "Rochester, NY", "Sacramento, CA", "Salt Lake City, UT", "San Antonio, TX", "San Diego, CA", "San Francisco, CA", "San Jose, CA", "Seattle, WA", "Spokane, WA", "St. Louis, MO", "Syracuse, NY", "Tampa, FL", "Toronto, ON", "Tucson, AZ", "Tulsa, OK", "Vancouver, BC", "Virginia Beach, VA", "Washington, DC", "Wichita, KS", "Winnipeg, MB" ], "type": "string", "description": "Pick a city (every entry live-verified to have its own Marketplace page — US + Canada). Not listed? Use 'Other city' below — it overrides this dropdown." }, "customLocation": { "title": "Other city (overrides the dropdown)", "type": "string", "description": "Any other city as 'City, State'. Must be big enough to have its own Marketplace page — small towns fail with a clear error and are never charged." }, "radius": { "title": "Search radius (miles)", "type": "integer", "description": "How far from the location to search.", "default": 100 }, "minPrice": { "title": "Minimum price", "type": "integer", "description": "Skip listings priced below this.", "default": 0 }, "maxPrice": { "title": "Maximum price", "type": "integer", "description": "Skip listings priced above this.", "default": 100000 }, "maxItems": { "title": "Max results", "type": "integer", "description": "Stop after collecting this many unique listings (across all queries). Facebook loads results by scrolling, so very large values may return fewer if Facebook stops loading more.", "default": 100 }, "includeRelated": { "title": "Include Facebook's related suggestions", "type": "boolean", "description": "Facebook pads search results with loosely-related listings (search 'tacoma', get F-150s at the end). By default those are filtered out so you only get listings containing your search words. Turn this on to keep them. Only affects keyword searches.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Facebook blocks datacenter IPs, so RESIDENTIAL proxies are strongly recommended. This is required for reliable results.", "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 } } }, "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 } } } } } } } } } }