{ "openapi": "3.0.1", "info": { "title": "Flippa.com Listings Scraper", "description": "Scrapes listing data from Flippa.com search pages. Supports filters by status, property type, and sale method.", "version": "1.0", "x-build-id": "nLdXkWDfKlHJZengR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/epicscrapers~flippa-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-epicscrapers-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/epicscrapers~flippa-scraper/runs": { "post": { "operationId": "runs-sync-epicscrapers-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/epicscrapers~flippa-scraper/run-sync": { "post": { "operationId": "run-sync-epicscrapers-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": { "keyword": { "title": "Keyword", "type": "string", "description": "Search words, as in Flippa's search box. Example: `shopify`, `ai chatbot`. Leave empty for all listings." }, "status": { "title": "Listing status", "type": "array", "description": "`open` = for sale now. `won` = auction ended with a winning bid. `completed` = sale completed. `expired` = ended without a sale. Pick several to search each one.", "items": { "type": "string", "enum": [ "open", "won", "completed", "expired" ], "enumTitles": [ "Open (for sale)", "Won (auction sold)", "Completed (sale completed)", "Expired (not sold)" ] }, "default": [ "open" ] }, "categories": { "title": "Categories", "type": "array", "description": "Flippa's business categories. Empty = all categories.", "items": { "type": "string", "enum": [ "saas", "ecommerce", "content", "amazon-fba", "amazon-kdp", "ai-apps-and-tools", "ios-apps", "android-apps", "plugins-and-extensions", "marketplaces", "newsletters", "youtube-channels", "social-media-accounts", "services", "digital-agencies", "domain", "crypto-and-blockchain", "projects-and-concepts", "other" ], "enumTitles": [ "SaaS", "Ecommerce", "Content sites", "Amazon FBA", "Amazon KDP", "AI apps and tools", "iOS apps", "Android apps", "Plugins and extensions", "Marketplaces", "Newsletters", "YouTube channels", "Social media accounts", "Services", "Digital agencies", "Domains", "Crypto and blockchain", "Projects and concepts", "Other" ] } }, "industries": { "title": "Industries", "type": "array", "description": "Niche of the business (Flippa's `industry` field). Empty = all industries.", "items": { "type": "string", "enum": [ "automotive", "business", "design-and-style", "education", "electronics", "entertainment", "food-and-drink", "general-knowledge", "health-and-beauty", "hobbies-and-games", "home-and-garden", "internet", "lifestyle", "sports-and-outdoor", "travel" ], "enumTitles": [ "Automotive", "Business", "Design and style", "Education", "Electronics", "Entertainment", "Food and drink", "General knowledge", "Health and beauty", "Hobbies and games", "Home and garden", "Internet", "Lifestyle", "Sports and outdoor", "Travel" ] } }, "saleMethod": { "title": "Sale method", "enum": [ "auction", "classified" ], "type": "string", "description": "`auction` = bidding with an end date. `classified` = fixed asking price. Empty = both." }, "managedBy": { "title": "Sold by", "type": "array", "description": "Who runs the sale. Empty = everyone.", "items": { "type": "string", "enum": [ "owner", "flippa_broker", "partner_broker" ], "enumTitles": [ "Owner", "Flippa broker", "Partner broker" ] } }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "type": "integer", "description": "Lowest current price or bid, in USD." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "type": "integer", "description": "Highest current price or bid, in USD." }, "minMonthlyProfit": { "title": "Min monthly profit (USD)", "minimum": 0, "type": "integer", "description": "Lowest net profit per month, in USD. Listings without a profit figure are left out." }, "maxMonthlyProfit": { "title": "Max monthly profit (USD)", "minimum": 0, "type": "integer", "description": "Highest net profit per month, in USD." }, "minMonthlyRevenue": { "title": "Min monthly revenue (USD)", "minimum": 0, "type": "integer", "description": "Lowest revenue per month, in USD. Listings without a revenue figure are left out." }, "maxMonthlyRevenue": { "title": "Max monthly revenue (USD)", "minimum": 0, "type": "integer", "description": "Highest revenue per month, in USD." }, "maxProfitMultiple": { "title": "Max profit multiple", "minimum": 0, "type": "number", "description": "Highest price ÷ yearly profit. Example: `3` keeps listings priced at 3× annual profit or less. Listings without profit are left out." }, "minMonthlyVisitors": { "title": "Min monthly visitors", "minimum": 0, "type": "integer", "description": "Lowest unique visitors per month." }, "minAgeYears": { "title": "Min business age (years)", "minimum": 0, "type": "number", "description": "Keeps businesses established at least this many years ago." }, "onlyVerifiedRevenue": { "title": "Only verified revenue", "type": "boolean", "description": "Keep only listings whose revenue Flippa has verified.", "default": false }, "onlyVerifiedTraffic": { "title": "Only verified traffic", "type": "boolean", "description": "Keep only listings whose traffic Flippa has verified.", "default": false }, "sellerCountries": { "title": "Seller countries", "type": "array", "description": "Seller location as an English country name (`United States`, `Australia`) or a common code (`US`, `UK`, `AU`). Empty = all countries.", "items": { "type": "string" } }, "endingWithinDays": { "title": "Ending within (days)", "minimum": 0, "type": "number", "description": "Keep open listings that end within this many days. Useful with `saleMethod: auction`." }, "sortBy": { "title": "Sort by", "enum": [ "most_recent", "most_relevant", "lowest_price", "highest_price", "ending_soonest", "most_active", "most_profitable" ], "type": "string", "description": "Order of results. With more than 10,000 matches the search is split by price, and results come in price ranges.", "default": "most_recent" }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Most listings to save. `0` = no limit. You pay per saved listing.", "default": 100 }, "listingIds": { "title": "Listing IDs or URLs", "type": "array", "description": "Look up specific listings instead of searching. Example: `12821301` or `https://flippa.com/12821301`. When set, all search filters are ignored.", "items": { "type": "string" } }, "changeTracking": { "title": "Only new or changed listings", "enum": [ "off", "newOnly", "newAndChanged" ], "type": "string", "description": "For scheduled runs. `newOnly` saves only listings this search has not returned before. `newAndChanged` also saves listings whose price, bid count, asking price or status changed, with the old and new values in `changes`. The first run saves everything. `off` saves every match.", "default": "off" }, "changeTrackingKey": { "title": "Change tracking name", "type": "string", "description": "Optional name for the remembered state, e.g. `saas-under-50k`. By default each distinct search gets its own state, so changing a filter starts fresh. Letters, digits, - and _." }, "url": { "title": "Flippa search URL (legacy)", "type": "string", "description": "Optional. A flippa.com/search URL; its status, category, sale method, price and keyword filters are used. Fields set above take priority." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Flippa rate-limits each IP. The default Apify Proxy switches IP when that happens.", "default": { "useApifyProxy": 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 } } } } } } } } } }