{ "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": "t2W3cIcOPIth7uTBG" }, "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": "Flippa search or category page to scrape, for example https://flippa.com/search?query[keyword]=food. If you set any search filter below (search term, category, price or revenue range), the filters are used and this URL is ignored. Sort order applies to 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. When any search filter is set, the Start URL is ignored." }, "category": { "title": "Category", "type": "string", "description": "Flippa category, for example saas, ecommerce, content, ios-apps, youtube-channels, amazon-fba, or an industry such as food-and-drink or health-and-beauty. Any other text is added to the search words." }, "priceMin": { "title": "Minimum Price", "type": "integer", "description": "Minimum asking price (USD)." }, "priceMax": { "title": "Maximum Price", "type": "integer", "description": "Maximum asking price (USD)." }, "revenueMin": { "title": "Minimum Revenue", "type": "integer", "description": "Minimum monthly revenue (USD)." }, "revenueMax": { "title": "Maximum Revenue", "type": "integer", "description": "Maximum monthly revenue (USD)." }, "sortBy": { "title": "Sort By", "enum": [ "price_asc", "price_desc", "revenue_asc", "revenue_desc", "newest", "oldest", "lowest_price", "highest_price", "most_profitable", "most_recent", "ending_soonest", "most_active" ], "type": "string", "description": "Sort results by. Flippa's search offers: lowest_price, highest_price, most_profitable, most_recent, ending_soonest, most_active. The older values price_asc, price_desc, revenue_desc and newest map to these; revenue_asc and oldest are no longer offered by Flippa and use its default order." }, "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 } } } } } } } } } }