{ "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Listing Scraper", "description": "Collect public Facebook Marketplace listings from search, browse, location, or listing URLs. Get the ID, URL, title, price, currency, location, availability, main image, and collection time for each saved listing. No Facebook login or API key is required.", "version": "0.0", "x-build-id": "u0VhLhzgzueacJ2pD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~facebook-marketplace-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-facebook-marketplace-listings", "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/maximedupre~facebook-marketplace-listings/runs": { "post": { "operationId": "runs-sync-maximedupre-facebook-marketplace-listings", "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/maximedupre~facebook-marketplace-listings/run-sync": { "post": { "operationId": "run-sync-maximedupre-facebook-marketplace-listings", "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", "required": [ "findBy" ], "properties": { "findBy": { "title": "Find listings by", "enum": [ "searchUrls", "keywordLocation", "coordinatesRadius", "directListingLookup" ], "type": "string", "description": "Choose one way to find Facebook Marketplace listings for this run." }, "searchUrls": { "title": "Marketplace search URLs", "minItems": 1, "type": "array", "description": "Add one or more public Facebook Marketplace search or browse URLs. Filters already in each URL are used. This field is required when Marketplace search URLs is selected.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keyword": { "title": "Product keyword", "minLength": 1, "type": "string", "description": "Words for the item you want to find, such as \"mountain bike\". This field is required when Keyword and location is selected." }, "location": { "title": "City or location", "minLength": 1, "type": "string", "description": "A city or other place to search, such as \"Austin, Texas\". This field is required when Keyword and location is selected." }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "The center latitude in decimal degrees, from -90 to 90. This field is required when Coordinates and radius is selected." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "The center longitude in decimal degrees, from -180 to 180. This field is required when Coordinates and radius is selected." }, "radiusKm": { "title": "Radius in kilometers", "minimum": 0.1, "type": "number", "description": "How far from the center to search, in kilometers. Use a positive number. This field is required when Coordinates and radius is selected." }, "listingUrls": { "title": "Listing URLs", "minItems": 1, "type": "array", "description": "Add one or more public Facebook Marketplace listing URLs when you already know the listings to collect. This field is required when Direct listing lookup is selected.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeRichDetails": { "title": "Include rich listing details", "type": "boolean", "description": "Turn this on to collect full descriptions, extra public media, condition and other attributes, public seller details, delivery options, precise coordinates, and category details such as vehicle specifications when available.", "default": false }, "maxItems": { "title": "Maximum listings", "minimum": 1, "type": "integer", "description": "Stop after this many listing records. Leave this empty to return all available results until the source is exhausted. Facebook may return fewer listings." } } }, "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 } } } } } } } } } }