{ "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper: listings, prices & details", "description": "Scrape Facebook Marketplace listings by keyword, city or category: price, location, photos, date, sold status, and with details the description, every photo, vehicle specs and rental details. Price, condition, date and delivery filters. No login, no browser.", "version": "0.1", "x-build-id": "h5KXmwznZ6QQZnUa7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pikoulas~facebook-marketplace/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pikoulas-facebook-marketplace", "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/pikoulas~facebook-marketplace/runs": { "post": { "operationId": "runs-sync-pikoulas-facebook-marketplace", "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/pikoulas~facebook-marketplace/run-sync": { "post": { "operationId": "run-sync-pikoulas-facebook-marketplace", "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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords searched on Marketplace in each location below, as its search box does.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Where to search: city names (\"Austin, TX\", \"London, UK\"; add the state or country, as Marketplace ranks places near the run's IP first), ZIP codes, \"latitude,longitude\", or Marketplace URLs of a place (facebook.com/marketplace/nyc/). Each search term is searched in each location.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "vehicles", "cars", "motorcycles", "propertyrentals", "propertyforsale", "apparel", "classifieds", "electronics", "entertainment", "family", "free", "garden", "hobbies", "home", "home-improvements", "instruments", "office-supplies", "pets", "sports", "toys", "furniture", "household", "bicycles" ], "type": "string", "description": "Browse a category in each location, or narrow the search terms to it. Cars, Motorcycles, Home improvement supplies and Office supplies can be browsed but not searched with a term on Marketplace." }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "In the location's currency, whole units." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "In the location's currency, whole units." }, "condition": { "title": "Condition", "type": "array", "description": "Only items in these conditions (items that have one; vehicles and rentals don't).", "items": { "type": "string", "enum": [ "new", "used_like_new", "used_good", "used_fair" ], "enumTitles": [ "New", "Used - like new", "Used - good", "Used - fair" ] } }, "daysSinceListed": { "title": "Listed in the last (days)", "minimum": 1, "type": "integer", "description": "Only listings posted in the last 1, 7 or 30 days, or any number." }, "deliveryMethod": { "title": "Delivery method", "enum": [ "all", "local_pick_up", "shipping" ], "type": "string", "description": "Local pickup only, shipping only, or both.", "default": "all" }, "sortBy": { "title": "Sort by", "enum": [ "best_match", "price_ascend", "price_descend", "creation_time_descend", "distance_ascend" ], "type": "string", "description": "The order Marketplace gives listings in.", "default": "best_match" }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 500, "type": "integer", "description": "How far around each location to search. Marketplace's default is 65 km (40 miles).", "default": 65 }, "maxListingsPerSearch": { "title": "Max listings per search", "minimum": 1, "type": "integer", "description": "Listings taken from each search (each term in each location, each URL). Marketplace pages through a thousand and more for a common term in a big city.", "default": 100 }, "includeDetails": { "title": "Include details", "type": "boolean", "description": "Each listing's page too: description, every photo and video, exact coordinates, ZIP code, attributes (condition, brand), vehicle specs (make, model, mileage, VIN, title status) and rental details (beds, baths, laundry, walk score). Charged as Listing with details, and about 80 KB of traffic a listing.", "default": false }, "urls": { "title": "Marketplace URLs", "type": "array", "description": "Search and category pages (facebook.com/marketplace/nyc/search?query=bike&maxPrice=500, facebook.com/marketplace/la/vehicles), scraped with the filters in their URL, and listing URLs or IDs (facebook.com/marketplace/item/...), scraped with their details.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Facebook refuses Apify's own IPs, so a run with none set switches to Apify's residential proxy by itself, charged as residential traffic. A US residential proxy is what works.", "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 } } } } } } } } } }