{ "openapi": "3.0.1", "info": { "title": "FLIPPA.com $0.8💰 URL | Filters | Enriched Output", "description": "From $0.8/1K. Scrape FLIPPA.com with full enrichment. Extract profit, revenue, multiples, traffic, age, location, monetization, badges, and more. Combines search JSON and listing API data. Supports filters or URL input, concurrent enrichment, and fast, low-resource runs.", "version": "1.0", "x-build-id": "8L0GFUBuZcecOm8Al" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~flippa-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-flippa-com-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/abotapi~flippa-com-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-flippa-com-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/abotapi~flippa-com-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-flippa-com-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", "required": [ "mode" ], "properties": { "mode": { "title": "Search Mode", "enum": [ "search", "url" ], "type": "string", "description": "Pick how to find listings. Search builds URLs from filters. URL mode pastes ready-made flippa.com URLs.", "default": "search" }, "status": { "title": "Listing Status", "uniqueItems": true, "type": "array", "description": "Open auctions/classifieds, recently sold, or both.", "items": { "type": "string", "enum": [ "open", "won" ], "enumTitles": [ "Open", "Recently Sold" ] } }, "propertyTypes": { "title": "Asset Types", "type": "array", "description": "Asset types. Leave empty to include all. Pick any of: website, fba, saas, ecommerce_store, plugin_and_extension, ai_apps_and_tools, youtube, ios_app, android_app, game, crypto_app, social_media, newsletter, service_and_agency, service, projects_and_concepts, domain, other.", "items": { "type": "string" } }, "siteTypes": { "title": "Site Types", "type": "array", "description": "Granular site type within an asset type. Examples: BrowserExtension, ShopifyPlugin, WordpressPlugin, AiAppsAndTools, Newsletter, SocialMedia, Youtube, CryptoApp, MarketingAgency, SoftwareDevelopmentAgency, ContentAndMediaProject, MobileAppProject, SaasAndSoftwareProject, OtherProject. Leave empty for any.", "items": { "type": "string" } }, "saleMethods": { "title": "Sale Methods", "uniqueItems": true, "type": "array", "description": "Auction or Classified (asking price). Leave empty for both.", "items": { "type": "string", "enum": [ "auction", "classified" ], "enumTitles": [ "Auction", "Classified" ] } }, "sortBy": { "title": "Sort By", "enum": [ "most_relevant", "most_recent", "ending_soonest", "most_active" ], "type": "string", "description": "Sort order for results.", "default": "most_relevant" }, "minPrice": { "title": "Min Price (USD)", "minimum": 0, "type": "integer", "description": "Minimum asking price. Leave empty for no minimum." }, "maxPrice": { "title": "Max Price (USD)", "minimum": 0, "type": "integer", "description": "Maximum asking price. Leave empty for no maximum." }, "minMonthlyProfit": { "title": "Min Monthly Profit (USD)", "minimum": 0, "type": "integer", "description": "Minimum monthly net profit. Leave empty for no minimum." }, "maxMonthlyProfit": { "title": "Max Monthly Profit (USD)", "minimum": 0, "type": "integer", "description": "Maximum monthly net profit. Leave empty for no maximum." }, "minMonthlyRevenue": { "title": "Min Monthly Revenue (USD)", "minimum": 0, "type": "integer", "description": "Minimum monthly revenue. Leave empty for no minimum." }, "maxMonthlyRevenue": { "title": "Max Monthly Revenue (USD)", "minimum": 0, "type": "integer", "description": "Maximum monthly revenue. Leave empty for no maximum." }, "minUniquesPerMonth": { "title": "Min Uniques per Month", "minimum": 0, "type": "integer", "description": "Minimum monthly unique visitors. Leave empty for no minimum." }, "minAgeMonths": { "title": "Min Age (months)", "minimum": 0, "type": "integer", "description": "Minimum age in months. Leave empty for no minimum." }, "maxAgeMonths": { "title": "Max Age (months)", "minimum": 0, "type": "integer", "description": "Maximum age in months. Leave empty for no maximum." }, "tlds": { "title": "Domain Extensions (TLD)", "type": "array", "description": "Limit to specific domain extensions. Examples: com, org, net, io, co, ai, app. Leave empty for any.", "items": { "type": "string" } }, "sellerLocation": { "title": "Seller Location", "type": "string", "description": "ISO 2-letter country code (e.g. us, gb, au) or region code (afr, nam, sam, asi, eeu, weu, oce). Leave empty for any." }, "verifiedRevenueOnly": { "title": "Verified Revenue Only", "type": "boolean", "description": "Only listings with Flippa-verified revenue.", "default": false }, "verifiedTrafficOnly": { "title": "Verified Traffic Only", "type": "boolean", "description": "Only listings with Flippa-verified traffic.", "default": false }, "manuallyVettedOnly": { "title": "Manually Vetted Only", "type": "boolean", "description": "Only listings the Flippa team or broker has manually vetted.", "default": false }, "editorsChoiceOnly": { "title": "Editor's Choice Only", "type": "boolean", "description": "Only Editor's Choice listings.", "default": false }, "superSellerOnly": { "title": "Super Seller Only", "type": "boolean", "description": "Only listings from Super Sellers.", "default": false }, "brokerSellerOnly": { "title": "Brokered Listings Only", "type": "boolean", "description": "Only brokered listings.", "default": false }, "sponsoredOnly": { "title": "Sponsored Only", "type": "boolean", "description": "Only sponsored (premium) listings.", "default": false }, "buyItNowOnly": { "title": "Buy It Now Only", "type": "boolean", "description": "Auctions with Buy It Now option.", "default": false }, "reserveMetOnly": { "title": "Reserve Met Only", "type": "boolean", "description": "Auctions where the reserve has been met.", "default": false }, "priceDroppedOnly": { "title": "Price Reduced Only", "type": "boolean", "description": "Listings whose price has been reduced.", "default": false }, "managedByFlippaOnly": { "title": "Managed by Flippa Only", "type": "boolean", "description": "Only listings managed by the Flippa team.", "default": false }, "earlyAccessOnly": { "title": "First Access Only", "type": "boolean", "description": "Only First-Access listings.", "default": false }, "revenueGenerating": { "title": "Revenue Generating", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Filter by whether the listing is currently revenue generating.", "default": "any" }, "urls": { "title": "Direct URLs", "type": "array", "description": "Paste any flippa.com URLs to scrape directly. Supports search-results URLs (https://flippa.com/search?...) and listing URLs (https://flippa.com/12345 or https://flippa.com/12345-some-slug). Multi-URL is supported. Filter-mode fields are ignored. Pagination starts at the page in each URL and walks forward.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch Detail Data", "type": "boolean", "description": "When ON, also fetches the per-listing /v3/listings/{id} record. Adds external_url, hostname, business_model, industry, revenue_per_month, profit_per_month, app_downloads_per_month, revenue_sources, and seller_location. Costs one extra HTTP call per listing.", "default": true }, "maxListings": { "title": "Max Listings", "minimum": 0, "type": "integer", "description": "Hard cap on listings pushed to the dataset. This is the actor's sole finite default limit. 0 means unlimited (bounded only by Max Pages and Flippa's own ~10,000-listing / 400-page ceiling).", "default": 20 }, "maxPages": { "title": "Max Pages per Search", "minimum": 0, "type": "integer", "description": "Maximum pages to walk per search URL. Leave at 0 to walk the whole result set for that search: the run still stops at Flippa's own real ~10,000-listing / 400-page ceiling, at the result total the server reports for a narrower search, or on an empty/all-duplicate page — never an artificial cap. Set a positive number to limit pages explicitly.", "default": 0 }, "resumeFromRunId": { "title": "Resume from a previous run (delta)", "type": "string", "description": "Optional. ID of a previous run of this actor (or a dataset ID). Listings already in that dataset are skipped, so this run returns only NEW listings (a delta). Combine both runs' datasets for the full set. Cannot be combined with Incremental mode unless this is the very first incremental run for the chosen state key (see below) — otherwise turn Incremental mode on for later scheduled runs instead." }, "incrementalMode": { "title": "Incremental mode (recurring monitoring)", "type": "boolean", "description": "For scheduled/repeated runs of the SAME search or URLs. The actor remembers what it saw last time and marks each listing NEW, UPDATED, UNCHANGED, REAPPEARED, or EXPIRED. Unlike Resume above (which continues one specific interrupted run from a pasted id), this remembers state itself between runs — no id to paste. Off by default so a normal run's output is unchanged.", "default": false }, "stateKey": { "title": "State key (incremental mode only)", "type": "string", "description": "Optional name for this monitoring campaign, used with Incremental mode above. Leave empty to key the saved state automatically off the search filters (or URLs) and Fetch Detail Data setting, so two different searches never share a baseline. Set an explicit name to track the same campaign even if you later tweak filters, or to run several separate campaigns against the same filters." }, "emitUnchanged": { "title": "Also return unchanged listings (incremental mode only)", "type": "boolean", "description": "When Incremental mode is on, UNCHANGED listings are normally skipped so you only see what's new or different. Turn this on to also return them, tagged changeType: UNCHANGED. These rows are returned AND billed like any other row. Off by default.", "default": false }, "emitExpired": { "title": "Also return expired listings (incremental mode only)", "type": "boolean", "description": "When Incremental mode is on and this run scans the full tracked search to its natural end, listings previously seen but no longer found are returned as tombstone rows tagged changeType: EXPIRED. These rows are returned AND billed like any other row. Skipped whenever this run does not prove a complete scan (e.g. Resume is set, Max Listings capped the run, or pagination stopped early) — the previous state for those listings is kept as-is. Off by default.", "default": false }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Default Apify proxy works fine for flippa.com. Residential is optional and rarely needed." }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON — the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } }, "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 } } } } } } } } } }