{ "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper πŸ›’ Sellers, Vehicles & Rentals", "description": "Scrape Facebook Marketplace listings by keyword, category, city or link β€” no login or cookies. Title, price, seller, city and photo on every listing; add description, condition, all photos, exact location, listing date, vehicle and rental details. Any city worldwide, every filter.", "version": "0.0", "x-build-id": "dHey4fnvBpriubtuF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dz_omar~facebook-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dz_omar-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/dz_omar~facebook-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-dz_omar-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/dz_omar~facebook-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-dz_omar-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": { "searchQueries": { "title": "πŸ” Keywords", "type": "array", "description": "What to search for, one keyword per line β€” exactly as you would type it in Marketplace's search box (e.g. iphone 13, sofa, honda civic).", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "location": { "title": "πŸ“ Location (for keywords and categories)", "maxLength": 200, "type": "string", "description": "City to search around β€” any city worldwide. Write it the way you would on a map: Austin, TX, Toronto, Lyon, France, Manchester, UK. Coordinates also work: 40.7128,-74.0060. Not used for Marketplace links (they keep their own location)." }, "radiusKm": { "title": "πŸ“ Search radius (km)", "minimum": 1, "maximum": 500, "type": "integer", "description": "How far from the location to look. Leave empty for Facebook's default (65 km). Facebook offers 1, 2, 5, 10, 20, 40, 60, 80, 100, 250 and 500 km." }, "strictRadius": { "title": "Stay inside the radius", "type": "boolean", "description": "When local results run out, Facebook keeps going with listings from further away (e.g. a Boise search drifting to Portland and Reno). Turn this on to drop listings whose city is outside the radius and stop once results are only from outside. Each kept listing gets an approximate distance_km.", "default": false }, "categories": { "title": "πŸ—‚οΈ Categories (optional)", "type": "array", "description": "With keywords: each keyword is searched inside each chosen category. Without keywords: the newest listings of each category near the location are collected.", "items": { "type": "string", "enum": [ "vehicles", "propertyrentals", "electronics", "home", "home-improvements", "apparel", "family", "entertainment", "garden", "hobbies", "instruments", "office-supplies", "pets", "sports", "toys", "classifieds", "free" ], "enumTitles": [ "Vehicles", "Property rentals", "Electronics", "Home goods", "Home improvement supplies", "Apparel", "Family", "Entertainment", "Garden & outdoor", "Hobbies", "Musical instruments", "Office supplies", "Pet supplies", "Sporting goods", "Toys & games", "Classifieds", "Free stuff" ] } }, "startUrls": { "title": "πŸ”— Marketplace links (search, category or listing)", "type": "array", "description": "Links copied from Facebook Marketplace, one per line:
β€’ a search β€” https://www.facebook.com/marketplace/nyc/search?query=bike&maxPrice=300
β€’ a category β€” https://www.facebook.com/marketplace/seattle/vehicles
β€’ a listing β€” https://www.facebook.com/marketplace/item/1234567890/ (always returned with full details)", "items": { "type": "string", "pattern": "^\\s*(https?://)?([a-z0-9-]+\\.)?(facebook|fb)\\.com/marketplace/.+$" } }, "sortBy": { "title": "↕️ Sort by", "enum": [ "best_match", "creation_time_descend", "price_ascend", "price_descend", "distance_ascend" ], "type": "string", "description": "Order in which Facebook returns the listings.", "default": "best_match" }, "minPrice": { "title": "πŸ’² Min price", "minimum": 0, "type": "integer", "description": "In the local currency of the location." }, "maxPrice": { "title": "πŸ’² Max price", "minimum": 0, "type": "integer", "description": "In the local currency of the location." }, "daysSinceListed": { "title": "πŸ•’ Date listed", "enum": [ "any", "1", "7", "30" ], "type": "string", "description": "Only listings posted within this period.", "default": "any" }, "itemCondition": { "title": "🏷️ Condition", "type": "array", "description": "Leave empty for any condition.", "items": { "type": "string", "enum": [ "new", "used_like_new", "used_good", "used_fair" ], "enumTitles": [ "New", "Used – like new", "Used – good", "Used – fair" ] } }, "deliveryMethod": { "title": "🚚 Delivery method", "enum": [ "all", "local_pick_up", "shipping" ], "type": "string", "description": "Local pickup only, shipping only, or both.", "default": "all" }, "includeSold": { "title": "Include sold listings", "type": "boolean", "description": "Also return listings marked as sold (Facebook's \"Availability: sold\" filter).", "default": false }, "exactMatch": { "title": "Exact keyword match only", "type": "boolean", "description": "Only listings whose title contains the keyword exactly.", "default": false }, "maxResultsPerSearch": { "title": "πŸ”’ Max listings per search", "minimum": 0, "type": "integer", "description": "For each keyword, category or link. 0 = everything Facebook returns for that search.", "default": 100 }, "maxResultsTotal": { "title": "πŸ”’ Max listings in total (optional)", "minimum": 1, "type": "integer", "description": "Stop the whole run after this many listings, across all searches. Empty = no overall limit. The run's cost limit is also respected." }, "includeDetails": { "title": "πŸ“„ Include full listing details", "type": "boolean", "description": "Adds the description, condition and other attributes (mileage, bedrooms…), every photo, exact coordinates, listing date and the seller's profile (join date, rating, picture). Slower, and charged as an add-on per listing.", "default": 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 } } } } } } } } } }