{
  "openapi": "3.0.1",
  "info": {
    "title": "Flippa Scraper: Businesses for Sale, Sold Comps & Multiples",
    "description": "Scrape Flippa businesses for sale: asking price, monthly revenue and profit, profit and revenue multiples, age, traffic, MRR, churn, verification and broker data. Sold comparables and category snapshots with median multiples. Filter by type, industry, country, price, profit. No login.",
    "version": "0.1",
    "x-build-id": "FVgROcdEPAOD3YoCX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/oswaldocarabano~flippa-businesses-for-sale-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-oswaldocarabano-flippa-businesses-for-sale-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/oswaldocarabano~flippa-businesses-for-sale-scraper/runs": {
      "post": {
        "operationId": "runs-sync-oswaldocarabano-flippa-businesses-for-sale-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/oswaldocarabano~flippa-businesses-for-sale-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-oswaldocarabano-flippa-businesses-for-sale-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": {
          "outputType": {
            "title": "What to extract",
            "enum": [
              "listings",
              "listing-details",
              "sold",
              "category-snapshot"
            ],
            "type": "string",
            "description": "One row type per run. <b>listings</b>: online businesses for sale that match your filters, each with its public listing page (about 50 filled fields per row: asking price, monthly revenue and profit, margins, profit and revenue multiples, age, traffic, MRR, churn, app downloads, verification, broker track record, views and watchers). <b>listing-details</b>: the same row for the Flippa links you paste. <b>sold</b>: recently sold businesses (comparables) with their last asking price, and the final price of auctions. <b>category-snapshot</b>: one row per business type or industry with medians of price, revenue, profit and multiples plus an opportunity score.",
            "default": "listings"
          },
          "listingUrls": {
            "title": "Listing links (for listing-details)",
            "maxItems": 5000,
            "type": "array",
            "description": "Flippa listing pages, for example https://flippa.com/12000168-turnkey-ai-saas…, or just the listing id (12000168). Only the id is read from each entry. Pasting links with the type \"Businesses for sale\" switches the run to listing details; filters are not applied to pasted links. Entries that are not Flippa listing links get one error row that is not charged.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Rows delivered (and charged) at most. Duplicates and error rows are never charged. About 6,080 businesses are for sale and about 1,120 sold ones are listed (17 Oct 2026). When you paste listing links and leave this empty, every one of them is delivered."
          },
          "includeDetails": {
            "title": "Open each listing page",
            "type": "boolean",
            "description": "On (recommended): each row adds the public listing page — exact monthly profit in the seller's currency, profit margin, revenue multiple, traffic, MRR, subscribers, churn, app rating and downloads, the \"About the business\" text, Flippa vetting, broker track record, payment methods, views and watchers. Off: search-result fields only (about 30), several times faster.",
            "default": true
          },
          "propertyTypes": {
            "title": "Business types",
            "type": "array",
            "description": "Only these Flippa business types. Empty = every business type except domains (domains are a separate market of 10,000+ listings; pick \"Domains\" to include them).",
            "items": {
              "type": "string",
              "enum": [
                "saas",
                "ecommerce",
                "content",
                "youtube-channels",
                "amazon-kdp",
                "amazon-fba",
                "ios-apps",
                "android-apps",
                "digital-agencies",
                "services",
                "ai-apps-and-tools",
                "marketplaces",
                "social-media-accounts",
                "newsletters",
                "plugins-and-extensions",
                "crypto-and-blockchain",
                "projects-and-concepts",
                "other",
                "domain"
              ],
              "enumTitles": [
                "SaaS",
                "Ecommerce",
                "Content sites",
                "YouTube channels",
                "Amazon KDP",
                "Amazon FBA",
                "iOS apps",
                "Android apps",
                "Digital agencies",
                "Services",
                "AI apps & tools",
                "Marketplaces",
                "Social media accounts",
                "Newsletters",
                "Plugins & extensions",
                "Crypto & blockchain",
                "Projects & concepts",
                "Other",
                "Domains (10,000+)"
              ]
            },
            "default": []
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Only these Flippa industries (verticals).",
            "items": {
              "type": "string",
              "enum": [
                "automotive",
                "business",
                "design-and-style",
                "education",
                "electronics",
                "entertainment",
                "lifestyle",
                "food-and-drink",
                "general-knowledge",
                "health-and-beauty",
                "hobbies-and-games",
                "home-and-garden",
                "internet",
                "sports-and-outdoor",
                "travel"
              ],
              "enumTitles": [
                "Automotive",
                "Business",
                "Design and Style",
                "Education",
                "Electronics",
                "Entertainment",
                "Lifestyle",
                "Food and Drink",
                "General Knowledge",
                "Health and Beauty",
                "Hobbies and Games",
                "Home and Garden",
                "Internet",
                "Sports and Outdoor",
                "Travel"
              ]
            },
            "default": []
          },
          "countries": {
            "title": "Seller locations",
            "type": "array",
            "description": "Two-letter country codes of the business location (us, gb, ca, au…) or regions: nam (North America), weu (Western Europe), eeu (Eastern Europe), asi (Asia), oce (Oceania), sam (South America), afr (Africa). 2,296 of 6,083 open listings are in the US.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Flippa keyword search over titles and descriptions (for example \"dating\", \"AI writing\", \"pet\"). Letters, digits, spaces and simple punctuation only."
          },
          "minPrice": {
            "title": "Min asking price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Asking price, or current bid for auctions."
          },
          "maxPrice": {
            "title": "Max asking price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Asking price, or current bid for auctions."
          },
          "minMonthlyProfit": {
            "title": "Min monthly profit (USD)",
            "type": "integer",
            "description": "Net profit per month as listed."
          },
          "maxMonthlyProfit": {
            "title": "Max monthly profit (USD)",
            "type": "integer",
            "description": "Net profit per month as listed."
          },
          "minMonthlyRevenue": {
            "title": "Min monthly revenue (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Revenue per month as listed."
          },
          "maxMonthlyRevenue": {
            "title": "Max monthly revenue (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Revenue per month as listed."
          },
          "minProfitMultiple": {
            "title": "Min profit multiple",
            "minimum": 0,
            "type": "number",
            "description": "Asking price divided by the last 12 months of profit, as shown on Flippa (e.g. 2.5). Checked by the actor on each search result (Flippa's own multiple filter does not match the shown multiple); results without a multiple are skipped. A run checks up to 100 search results per requested row."
          },
          "maxProfitMultiple": {
            "title": "Max profit multiple",
            "minimum": 0,
            "type": "number",
            "description": "For example 3 = at most 3x yearly profit. Checked by the actor; see the min field."
          },
          "minRevenueMultiple": {
            "title": "Min revenue multiple",
            "minimum": 0,
            "type": "number",
            "description": "Asking price divided by 12 × monthly revenue. Checked by the actor on each search result."
          },
          "maxRevenueMultiple": {
            "title": "Max revenue multiple",
            "minimum": 0,
            "type": "number",
            "description": "For example 1 = priced at most at one year of revenue. Checked by the actor."
          },
          "minAgeYears": {
            "title": "Min age (years)",
            "minimum": 0,
            "maximum": 60,
            "type": "number",
            "description": "Business age as shown on Flippa (for example 3)."
          },
          "maxAgeYears": {
            "title": "Max age (years)",
            "minimum": 0,
            "maximum": 60,
            "type": "number",
            "description": "For example 1 = businesses up to one year old."
          },
          "saleMethod": {
            "title": "Sale method",
            "enum": [
              "any",
              "auction",
              "classified"
            ],
            "type": "string",
            "description": "Auctions (current bid, bids, time left, reserve) or classifieds (fixed asking price).",
            "default": "any"
          },
          "managedBy": {
            "title": "Listed by",
            "type": "array",
            "description": "Flippa brokers, partner brokers or the owners themselves (about 90% of listings).",
            "items": {
              "type": "string",
              "enum": [
                "flippa_broker",
                "partner_broker",
                "owner"
              ],
              "enumTitles": [
                "Flippa broker",
                "Partner broker",
                "Owner"
              ]
            },
            "default": []
          },
          "dataVerifiedOnly": {
            "title": "Only listings with connected data",
            "type": "boolean",
            "description": "Keep only listings whose seller connected Google Analytics, Stripe or another data source (shown as \"Data Verified\" on Flippa). Checked by the actor on each search result.",
            "default": false
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "relevance",
              "lowest-price",
              "highest-price",
              "most-profitable",
              "most-active",
              "ending-soonest"
            ],
            "type": "string",
            "description": "Flippa's own ordering of the results.",
            "default": "newest"
          },
          "snapshotGroupBy": {
            "title": "Group snapshots by",
            "enum": [
              "propertyType",
              "industry"
            ],
            "type": "string",
            "description": "For category-snapshot: one row per business type or per industry.",
            "default": "propertyType"
          },
          "maxCacheAgeHours": {
            "title": "Max age of cached listing pages (hours)",
            "minimum": 0,
            "maximum": 72,
            "type": "integer",
            "description": "Listing pages fetched by any run in the last N hours are reused (rows say when, in cachedAt). 0 = always live. Search results are always live.",
            "default": 12
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Listing pages fetched at the same time. 6 is fast and gentle; higher values finish large runs sooner.",
            "default": 6
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}