{
  "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": "mYQ238pTJka88AuVb"
  },
  "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. 0 means unlimited (capped only by maxPages and the platform's 10,000-listing total).",
            "default": 0
          },
          "maxPages": {
            "title": "Max Pages per Search",
            "minimum": 1,
            "maximum": 400,
            "type": "integer",
            "description": "Maximum pages to walk per search URL. Flippa's search returns 25 listings per page and caps at page 400 (10,000 listings total). The actor stops early when it reaches the result total reported by the server, so setting this to 400 is safe even for narrow filters.",
            "default": 1
          },
          "proxy": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Default Apify proxy works fine for flippa.com. Residential is optional and rarely needed."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}