{
  "openapi": "3.0.1",
  "info": {
    "title": "Flippa Scraper: Websites, SaaS, Apps & Domains for Sale",
    "description": "Scrape Flippa (flippa.com) data on online businesses for sale or recently sold: websites, SaaS, ecommerce stores, apps and domains with asking price, monthly revenue and profit, multiple, age, bids and verification. Optional listing pages. Export to JSON, CSV or Excel, or via API.",
    "version": "1.0",
    "x-build-id": "jZKosXHIv9a4eVPah"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/steadyscrape~flippa-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-steadyscrape-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/steadyscrape~flippa-scraper/runs": {
      "post": {
        "operationId": "runs-sync-steadyscrape-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/steadyscrape~flippa-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-steadyscrape-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": {
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "What kind of business to list, as Flippa's own category filter: <code>SaaS</code>, <code>Ecommerce</code>, <code>Content sites</code>, <code>iOS apps</code>, <code>YouTube channels</code>, <code>Domains</code>… Leave empty for every kind.",
            "items": {
              "type": "string",
              "enum": [
                "ecommerce",
                "content",
                "saas",
                "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",
                "domain",
                "other"
              ],
              "enumTitles": [
                "Ecommerce",
                "Content sites",
                "SaaS",
                "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",
                "Domains",
                "Other"
              ]
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Words to search Flippa for, one per line (<code>newsletter</code>, <code>shopify app</code>, <code>pet</code>). Each keyword is a separate search with the same filters. Leave empty to list everything the filters match. Up to 50.",
            "items": {
              "type": "string"
            }
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Flippa's industry filter (<code>Business</code>, <code>Health and Beauty</code>, <code>Internet</code>…). Leave empty for every industry.",
            "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"
              ]
            }
          },
          "listingStatus": {
            "title": "Listings",
            "enum": [
              "open",
              "sold",
              "open_and_sold"
            ],
            "type": "string",
            "description": "Listings for sale now, the ones Flippa lists as <b>Recently Sold</b> (comparables for valuations), or both.",
            "default": "open"
          },
          "saleMethod": {
            "title": "Sale method",
            "enum": [
              "any",
              "auction",
              "classified"
            ],
            "type": "string",
            "description": "Auctions, fixed-price (classified) listings, or both.",
            "default": "any"
          },
          "managedBy": {
            "title": "Listed by",
            "type": "array",
            "description": "Only listings brokered by Flippa, listed by a partner broker, or listed by their owner. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "flippa_broker",
                "partner_broker",
                "owner"
              ],
              "enumTitles": [
                "Brokered by Flippa",
                "Listed by a partner broker",
                "Listed by the owner"
              ]
            }
          },
          "minPrice": {
            "title": "Min price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest asking price."
          },
          "maxPrice": {
            "title": "Max price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest asking price."
          },
          "minMonthlyRevenue": {
            "title": "Min monthly revenue (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest average monthly revenue."
          },
          "maxMonthlyRevenue": {
            "title": "Max monthly revenue (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest average monthly revenue."
          },
          "minMonthlyProfit": {
            "title": "Min monthly profit (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest average monthly net profit."
          },
          "maxMonthlyProfit": {
            "title": "Max monthly profit (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest average monthly net profit."
          },
          "minProfitMultiple": {
            "title": "Min profit multiple",
            "minimum": 0,
            "type": "number",
            "description": "Lowest price ÷ 12 months of profit (e.g. <code>1.5</code>)."
          },
          "maxProfitMultiple": {
            "title": "Max profit multiple",
            "minimum": 0,
            "type": "number",
            "description": "Highest price ÷ 12 months of profit (e.g. <code>3</code> for listings at 3× yearly profit or less)."
          },
          "minAgeYears": {
            "title": "Min age (years)",
            "minimum": 0,
            "type": "integer",
            "description": "Youngest business, in years since it started."
          },
          "maxAgeYears": {
            "title": "Max age (years)",
            "minimum": 0,
            "type": "integer",
            "description": "Oldest business, in years."
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "most_relevant",
              "most_recent",
              "most_active",
              "lowest_price",
              "highest_price",
              "ending_soonest",
              "most_profitable"
            ],
            "type": "string",
            "description": "The order Flippa lists the results in; with a maximum below the total it decides which listings you get.",
            "default": "most_relevant"
          },
          "startUrls": {
            "title": "Flippa links",
            "type": "array",
            "description": "Links copied from flippa.com, one per line. A search with any filters set on the site (<code>https://flippa.com/search?filter[property_type][]=website</code>) or a category page (<code>https://flippa.com/buy/saas</code>) is walked like a search; a listing (<code>https://flippa.com/14144546-…</code>) is read on its own page and charged as a listing with details. The form above searches too when you give it keywords or a filter. Up to 5,000.",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerSearch": {
            "title": "Max listings per search",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop each search (each keyword, and each search link) after this many listings. Flippa shows at most 10,000 results of one search; narrow the filters to reach the rest. The run's spending limit is respected too.",
            "default": 100
          },
          "includeDetails": {
            "title": "Read each listing page (listing-with-details)",
            "type": "boolean",
            "description": "Also read every listing's own page: exact monthly profit in the listed currency, profit margin, page views, revenue multiple, SaaS figures (MRR, subscribers, churn), the <b>About the Business</b> text, what Flippa's vetting team verified and which data sources are connected, bids and reserve, Buy It Now price, inventory, a domain's registrar and expiry, the broker's public name and track record, views and watchers. Charged as <code>listing-with-details</code> instead of <code>listing</code>. Traffic charts, financial history and seller notes need a Flippa account and are not read.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}