{ "openapi": "3.0.1", "info": { "title": "Flippa Scraper", "description": "Target-aware live actor for Flippa Scraper. Scrape digital asset listings from Flippa.com including websites, ecommerce stores, SaaS, apps, and domains. Extract price, revenue, profit, traffic, verification, seller, and industry data.", "version": "0.1", "x-build-id": "nPf8ABtWVzTvVyf4M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeai~flippa-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeai-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/scrapeai~flippa-scraper/runs": { "post": { "operationId": "runs-sync-scrapeai-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/scrapeai~flippa-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeai-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": { "startUrls": { "title": "Target Start URLs", "type": "array", "description": "Live public target URLs to request first. These can be replaced at run time.", "items": { "type": "object", "properties": { "url": { "title": "URL", "description": "Absolute live target URL.", "type": "string" } }, "required": [ "url" ] }, "default": [ { "url": "https://flippa.com/search?filter%5Bproperty_type%5D%5B%5D=ecommerce_store&filter%5Bstatus%5D=open" } ] }, "endUrls": { "title": "Target End URLs", "type": "array", "description": "Optional live target boundary URLs. They are fetched after start URLs and are kept separate in output.", "items": { "type": "object", "properties": { "url": { "title": "URL", "description": "Absolute live target URL.", "type": "string" } }, "required": [ "url" ] }, "default": [] }, "query": { "title": "Search Query", "type": "string", "description": "Target query used by a derived source URL when the actor supports query search.", "default": "Flippa" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of live records to return. Production default/prefill is 50; maximum is 50. Local input.json stays capped at 10.", "default": 50 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "The direct adapter stops on request errors and does not retry.", "default": 1 }, "requestTimeoutSecs": { "title": "Request Timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Maximum time to wait for one live target request.", "default": 25 }, "maxPages": { "title": "Maximum Live Pages", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum live listing/API pages to request, including discovered next pages.", "default": 3 }, "crawlDetails": { "title": "Fetch Detail Pages", "type": "boolean", "description": "When live rows expose same-site item URLs, fetch those detail pages in bulk and attach their fields.", "default": true }, "maxDetailPages": { "title": "Maximum Detail Pages", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum same-site detail URLs to fetch per run.", "default": 5 }, "detailConcurrency": { "title": "Detail Concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Detail requests are currently made one at a time.", "default": 4 }, "browserFallback": { "title": "Browser DOM Fallback", "type": "boolean", "description": "Not supported by the current direct-page adapter; leave disabled.", "default": false }, "proxyEnabled": { "title": "Enable Apify Proxy", "type": "boolean", "description": "Not supported by the current direct-page adapter; leave disabled.", "default": false }, "targetInput": { "title": "Original Target Input", "type": "object", "description": "Optional source-specific fields copied from this actor input schema. URL/query values are normalized by this actor.", "properties": { "searchUrl": { "title": "Flippa Search URL", "type": "string", "description": "Flippa search URL whose filters are preserved. If empty, the structured filter fields below are used instead.", "prefill": "https://flippa.com/search?filter%5Bproperty_type%5D%5B%5D=ecommerce_store&filter%5Bstatus%5D=open" }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of listings to return; the current adapter caps output at 50.", "default": 50, "prefill": 5 }, "propertyType": { "title": "Property Type", "type": "array", "description": "Listing category. Used only when Search URL is empty. Leave blank to include all types." }, "status": { "title": "Status", "type": "string", "description": "Listing status. Sold listings are not exposed by Flippa's public API.", "default": "open" }, "saleMethod": { "title": "Sale Method", "type": "string", "description": "Auction or classified (fixed price)." }, "priceMin": { "title": "Minimum Price (USD)", "type": "integer", "description": "Minimum asking price." }, "priceMax": { "title": "Maximum Price (USD)", "type": "integer", "description": "Maximum asking price." }, "revenueMin": { "title": "Minimum Monthly Revenue (USD)", "type": "integer", "description": "Include only listings with at least this monthly revenue." }, "profitMin": { "title": "Minimum Monthly Profit (USD)", "type": "integer", "description": "Include only listings with at least this monthly profit." }, "verifiedRevenue": { "title": "Verified Revenue Only", "type": "boolean", "description": "Not yet supported for structured filters; leave false.", "default": false }, "verifiedTraffic": { "title": "Verified Traffic Only", "type": "boolean", "description": "Not yet supported for structured filters; leave false.", "default": false }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword search (e.g. 'shopify', 'saas', 'blog')." }, "sort": { "title": "Sort Order", "type": "string", "description": "How results are ordered.", "default": "-created_at" } }, "default": {}, "additionalProperties": true } } }, "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 } } } } } } } } } }