# Flippa Scraper (`gio21/flippa-scraper`) Actor

Scrape Flippa listings: online businesses, websites, SaaS, apps and domains for sale with price, revenue, profit, category, age and verification data. Search by keyword and filter by price or revenue.

- **URL**: https://apify.com/gio21/flippa-scraper.md
- **Developed by:** [Gio](https://apify.com/gio21) (community)
- **Categories:** Business, E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Flippa Scraper

Extract listings from [Flippa](https://flippa.com), the largest marketplace for buying and selling online businesses, websites, SaaS products, apps, ecommerce stores and domains.

Each listing includes asking price, monthly revenue and profit, revenue multiple, category, business age, country, verification badges and more.

Built for acquisition deal sourcing, market research, valuation benchmarking and investment analysis.

### Features

- **Keyword search** across all Flippa listings
- **Price and monthly-revenue filters** (min / max), enforced on every result
- Pass an exact Flippa search URL for advanced filter combinations (property type, monetization, sale method...)
- Rich output: 40+ fields per listing including verified revenue/traffic flags, profit multiples, bid counts and traffic stats
- Fast HTTP scraping, automatic pagination and de-duplication

### Input

| Field | Type | Description |
|-------|------|-------------|
| `searchQuery` | string | Keyword (e.g. "saas", "newsletter", "shopify"). |
| `startUrl` | string | Exact Flippa search URL. Overrides other filters. |
| `priceMin` / `priceMax` | integer | Asking price range in USD. |
| `revenueMin` / `revenueMax` | integer | Average monthly revenue range in USD. |
| `includeUnpriced` | boolean | Keep confidential / open-to-offer listings when a price filter is set. Default `false`. |
| `maxItems` | integer | Max listings. `0` = no limit. Default `100`. |
| `proxyConfiguration` | object | Apify Proxy recommended (default). |

#### Example input

```json
{
  "searchQuery": "saas",
  "priceMin": 50000,
  "priceMax": 300000,
  "maxItems": 100
}
````

### Output

```json
{
  "listingId": "12223339",
  "title": "Established SaaS business in Education with $63K ARR revenue",
  "propertyType": "SaaS",
  "price": 170000,
  "monthlyRevenue": 7411,
  "monthlyProfit": 3675,
  "revenueMultiple": 2.7,
  "category": "Education",
  "country": "United States",
  "ageYears": "8 years",
  "hasVerifiedRevenue": true,
  "hasVerifiedTraffic": true,
  "saleMethod": "classified",
  "url": "https://flippa.com/12223339"
}
```

### Common use cases

- Source online-business acquisition targets by budget and revenue
- Benchmark valuations: price-to-revenue multiples by category
- Track new SaaS / ecommerce / content listings daily
- Feed deal-flow tools, newsletters and investor dashboards

### Pricing

Pay per result: a small fee to start the run plus a per-listing fee. Errors and duplicates are never charged.

### FAQ

**Can I use Flippa's own filters?** Yes, build the search on flippa.com, copy the URL and pass it as `startUrl`.

**Why do some listings have no price?** Confidential and "open to offer" listings hide the price until you sign an NDA on Flippa. Exclude them with the default settings or keep them with `includeUnpriced`.

**Is this affiliated with Flippa?** No. This is an independent tool for extracting publicly available data. Please respect Flippa's terms of service.

# Actor input Schema

## `searchQuery` (type: `string`):

Keyword to search listings for (e.g. "saas", "ecommerce", "newsletter"). Leave empty to browse all listings.

## `startUrl` (type: `string`):

Exact Flippa search URL to scrape (e.g. https://flippa.com/search?query\[keyword]=food\&filters\[property\_type]=website). Overrides the keyword and filter fields.

## `priceMin` (type: `integer`):

Only include listings priced at or above this value.

## `priceMax` (type: `integer`):

Only include listings priced at or below this value.

## `revenueMin` (type: `integer`):

Only include listings with average monthly revenue at or above this value.

## `revenueMax` (type: `integer`):

Only include listings with average monthly revenue at or below this value.

## `includeUnpriced` (type: `boolean`):

Confidential and open-to-offer listings do not disclose a price. Include them even when a price filter is set.

## `maxItems` (type: `integer`):

Maximum number of listings to return. Set 0 for no limit.

## `proxyConfiguration` (type: `object`):

Proxy used for requests. Apify Proxy (automatic) is recommended.

## Actor input object example

```json
{
  "searchQuery": "saas",
  "includeUnpriced": false,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "saas"
};

// Run the Actor and wait for it to finish
const run = await client.actor("gio21/flippa-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchQuery": "saas" }

# Run the Actor and wait for it to finish
run = client.actor("gio21/flippa-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "saas"
}' |
apify call gio21/flippa-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=gio21/flippa-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Flippa Scraper",
        "description": "Scrape Flippa listings: online businesses, websites, SaaS, apps and domains for sale with price, revenue, profit, category, age and verification data. Search by keyword and filter by price or revenue.",
        "version": "0.0",
        "x-build-id": "tzsUY71Qd9q7u7zN1"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/gio21~flippa-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-gio21-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/gio21~flippa-scraper/runs": {
            "post": {
                "operationId": "runs-sync-gio21-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/gio21~flippa-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-gio21-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": {
                    "searchQuery": {
                        "title": "Search keyword",
                        "type": "string",
                        "description": "Keyword to search listings for (e.g. \"saas\", \"ecommerce\", \"newsletter\"). Leave empty to browse all listings."
                    },
                    "startUrl": {
                        "title": "Start URL (advanced)",
                        "type": "string",
                        "description": "Exact Flippa search URL to scrape (e.g. https://flippa.com/search?query[keyword]=food&filters[property_type]=website). Overrides the keyword and filter fields."
                    },
                    "priceMin": {
                        "title": "Min price (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only include listings priced at or above this value."
                    },
                    "priceMax": {
                        "title": "Max price (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only include listings priced at or below this value."
                    },
                    "revenueMin": {
                        "title": "Min monthly revenue (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only include listings with average monthly revenue at or above this value."
                    },
                    "revenueMax": {
                        "title": "Max monthly revenue (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only include listings with average monthly revenue at or below this value."
                    },
                    "includeUnpriced": {
                        "title": "Include listings without a public price",
                        "type": "boolean",
                        "description": "Confidential and open-to-offer listings do not disclose a price. Include them even when a price filter is set.",
                        "default": false
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of listings to return. Set 0 for no limit.",
                        "default": 100
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy used for requests. Apify Proxy (automatic) is recommended.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
