{ "openapi": "3.0.1", "info": { "title": "Flippa Listings Scraper", "description": "Collect public business listings from Flippa and Empire Flippers and return comparable records with asking price, monthly revenue and profit, profit multiple, age, business type, niche, location and status. Search by keyword and filters, or provide listing URLs.", "version": "0.1", "x-build-id": "66mziCBV71v7PdTXQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~flippa-empire-flippers-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-flippa-empire-flippers-listings-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/axiomworks~flippa-empire-flippers-listings-scraper/runs": { "post": { "operationId": "runs-sync-axiomworks-flippa-empire-flippers-listings-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/axiomworks~flippa-empire-flippers-listings-scraper/run-sync": { "post": { "operationId": "run-sync-axiomworks-flippa-empire-flippers-listings-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": "Start URLs", "type": "array", "description": "Optional. Flippa search or listing URLs (https://flippa.com/search?..., https://flippa.com/14144546) and Empire Flippers marketplace, category or listing URLs (https://empireflippers.com/listing/97464/). When set, only these are crawled and the filters below are applied to their records; leave empty to search by keyword and filters.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sources": { "title": "Marketplaces", "type": "array", "description": "Marketplaces to search when Start URLs is empty: 'flippa', 'empireflippers' or both (default both). With both, results alternate one by one so a small maxItems returns a mix.", "items": { "type": "string", "enum": [ "flippa", "empireflippers" ], "enumTitles": [ "Flippa", "Empire Flippers" ] }, "default": [ "flippa", "empireflippers" ] }, "keyword": { "title": "Keyword", "type": "string", "description": "Optional search words, e.g. 'amazon' or 'tienda'. Matched by each marketplace's own search. Leave empty to list everything that fits the other filters." }, "businessTypes": { "title": "Business types", "type": "array", "description": "Optional business models, mapped to each marketplace's own categories. A marketplace with no matching category (e.g. domain on Empire Flippers) is skipped. Leave empty for all types.", "items": { "type": "string", "enum": [ "ecommerce", "amazon_fba", "amazon_kdp", "saas", "content", "newsletter", "agency_service", "mobile_app", "youtube_social", "marketplace", "domain", "other" ], "enumTitles": [ "Ecommerce", "Amazon FBA", "Amazon KDP", "SaaS", "Content sites", "Newsletters", "Agencies and services", "Mobile apps", "YouTube and social media", "Marketplaces", "Domains", "Other" ] } }, "status": { "title": "Listing status", "enum": [ "for_sale", "sold", "all" ], "type": "string", "description": "'for_sale' (default) returns open listings, 'sold' returns completed sales, 'all' returns both. Ignored for Flippa start URLs, whose own filter decides.", "default": "for_sale" }, "sortBy": { "title": "Sort by", "enum": [ "newest", "price_asc", "price_desc", "profit_desc" ], "type": "string", "description": "Order of results within each marketplace: 'newest' (default), 'price_asc', 'price_desc' or 'profit_desc' (highest monthly profit first).", "default": "newest" }, "maxItems": { "title": "Maximum results", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum listings returned in total across both marketplaces and all start URLs, 1-10000, default 50; 0 means no limit. The run stops when this many are saved and you are charged only for results returned.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for all requests, default Apify Proxy (datacenter). Blocked requests are retried on a new IP automatically; switch to residential only if runs return nothing.", "default": { "useApifyProxy": true } }, "minPrice": { "title": "Minimum asking price (USD)", "minimum": 0, "type": "integer", "description": "Only listings asking at least this many US dollars, e.g. 100000. Applied by the marketplaces and again on the results." }, "maxPrice": { "title": "Maximum asking price (USD)", "minimum": 0, "type": "integer", "description": "Only listings asking at most this many US dollars, e.g. 1000000." }, "minMonthlyProfit": { "title": "Minimum monthly profit (USD)", "minimum": 0, "type": "integer", "description": "Only listings with at least this monthly net profit in US dollars, e.g. 5000." }, "maxMonthlyProfit": { "title": "Maximum monthly profit (USD)", "minimum": 0, "type": "integer", "description": "Only listings with at most this monthly net profit in US dollars." }, "minMonthlyRevenue": { "title": "Minimum monthly revenue (USD)", "minimum": 0, "type": "integer", "description": "Only listings with at least this monthly revenue in US dollars. Flippa figures are rounded to 3 digits on search pages." }, "maxMonthlyRevenue": { "title": "Maximum monthly revenue (USD)", "minimum": 0, "type": "integer", "description": "Only listings with at most this monthly revenue in US dollars." }, "minAgeYears": { "title": "Minimum business age (years)", "minimum": 0, "type": "number", "description": "Only businesses at least this many years old, e.g. 2 or 0.5." }, "maxAgeYears": { "title": "Maximum business age (years)", "minimum": 0, "type": "number", "description": "Only businesses at most this many years old." }, "minProfitMultiple": { "title": "Minimum profit multiple", "minimum": 0, "type": "number", "description": "Only listings priced at least this many times annual profit, e.g. 2.5 (annual multiple, like the 'x' shown by Flippa)." }, "maxProfitMultiple": { "title": "Maximum profit multiple", "minimum": 0, "type": "number", "description": "Only listings priced at most this many times annual profit, e.g. 4." }, "flippaCategories": { "title": "Flippa categories", "type": "array", "description": "Raw Flippa category slugs added to Business types, e.g. 'amazon-fba', 'saas', 'newsletters', 'youtube-channels'. Searches only Flippa unless Empire Flippers filters are also set.", "items": { "type": "string" } }, "flippaIndustries": { "title": "Flippa industries", "type": "array", "description": "Raw Flippa industry slugs, e.g. 'health-and-beauty', 'travel', 'food-and-drink', 'home-and-garden'.", "items": { "type": "string" } }, "efMonetizations": { "title": "Empire Flippers monetizations", "type": "array", "description": "Raw Empire Flippers monetization names added to Business types, e.g. 'Amazon FBA', 'SaaS', 'Affiliate', 'Lead Gen'. Searches only Empire Flippers unless Flippa filters are also set.", "items": { "type": "string" } }, "efNiches": { "title": "Empire Flippers niches", "type": "array", "description": "Raw Empire Flippers niche names, e.g. 'Pet Care', 'Health & Fitness', 'Automotive'.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }