{ "openapi": "3.0.1", "info": { "title": "Flippa Business Listings Scraper", "description": "Scrapes Flippa business listings by search query, category, price range, revenue range, or direct URL. Returns each listing as a flat row with price, revenue, profit, and seller details.", "version": "1.0", "x-build-id": "U6bs7Ot9f7adbFW7I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~flippa-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-flippa-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/parseforge~flippa-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-flippa-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/parseforge~flippa-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-flippa-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": { "startUrl": { "title": "Flippa listing URLs", "type": "string", "description": "Direct URL to scrape from Flippa (e.g., https://flippa.com/search?query[keyword]=food). You can use either startUrl OR search filters, but not both." }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of listings to collect per run." }, "searchQuery": { "title": "Search term for listings", "type": "string", "description": "Search term for business listings. You can use either startUrl OR search filters, but not both." }, "category": { "title": "Category", "type": "string", "description": "Business category filter" }, "priceMin": { "title": "Minimum Price", "type": "integer", "description": "Minimum listing price" }, "priceMax": { "title": "Maximum Price", "type": "integer", "description": "Maximum listing price" }, "revenueMin": { "title": "Minimum Revenue", "type": "integer", "description": "Minimum monthly revenue" }, "revenueMax": { "title": "Maximum Revenue", "type": "integer", "description": "Maximum monthly revenue" }, "sortBy": { "title": "Sort By", "enum": [ "price_asc", "price_desc", "revenue_asc", "revenue_desc", "newest", "oldest" ], "type": "string", "description": "Sort results by" }, "includeListingDetails": { "title": "📄 Include listing details", "type": "boolean", "description": "Adds the full business description, view, watcher and comment counts, the key metrics shown on the listing (monthly profit, profit margin, page views, active clients and similar), what Flippa vetted, connected data integrations, payment methods, reserve status and Buy It Now price, plus summary, monthly uniques, app rating and broker name. One extra request per listing, shared with Include seller profile. Charged only for a row that receives it.", "default": false }, "includeSellerProfile": { "title": "👤 Include seller profile", "type": "boolean", "description": "Adds who is selling: seller or broker name, profile URL, company, location, bio, avatar, completed verifications (email, phone, government ID) and their track record (number of transactions and total value). One extra request per listing, shared with Include listing details. Charged only for a row that receives it.", "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 } } } } } } } } } }