{ "openapi": "3.0.1", "info": { "title": "Flippa Scraper - Online Businesses & Websites For Sale", "description": "Scrapes Flippa's public API for online businesses for sale: websites, e-commerce stores, SaaS, Amazon FBA, apps and domains. Returns asking price, monthly revenue and profit, traffic, verification flags, auction state and seller location, with honest reporting of Flippa's 10,000 total clamp.", "version": "0.1", "x-build-id": "waOpPespzmOeabPpg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~flippa-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-flippa-listings-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/scrapyx~flippa-listings-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-flippa-listings-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/scrapyx~flippa-listings-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-flippa-listings-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": { "propertyTypes": { "title": "Property types", "type": "array", "description": "Flippa's own six top-level categories. These are CATEGORIES, not leaf types: 'website' covers e-commerce stores, content sites, SaaS, marketplaces and services, so rows come back with a more specific type than you asked for. Leave empty for everything.", "items": { "type": "string", "enum": [ "website", "fba", "ios_app", "android_app", "domain", "other" ], "enumTitles": [ "Websites (ecommerce, content, SaaS, marketplace, service)", "Amazon FBA & KDP", "iOS apps", "Android apps", "Domains", "Other" ] } }, "status": { "title": "Listing status", "enum": [ "any", "open" ], "type": "string", "description": "Restrict to currently open listings, or take everything. NOTE: Flippa's status filter is approximate — it lags the live listing state, so a few rows can come back 'completed'. Every row carries its own authoritative `status`; filter on that if you need exactness.", "default": "any" }, "saleMethod": { "title": "Sale method", "enum": [ "any", "auction", "classified" ], "type": "string", "description": "Auctions or fixed-price classifieds.", "default": "any" }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "type": "integer", "description": "Lower bound on the listing price." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "type": "integer", "description": "Upper bound on the listing price." }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Stop after this many listings. Set 0 for everything the query can reach — note Flippa clamps its own reported total at 10,000 for broad queries, so narrow by type or price to see the real count.", "default": 200 }, "pageSize": { "title": "Listings per request", "minimum": 1, "maximum": 100, "type": "integer", "description": "100 is the maximum and the sensible default: Flippa rate-limits by REQUEST, so fewer, larger pages is strictly better.", "default": 100 }, "minRequestInterval": { "title": "Min seconds between requests", "minimum": 0, "maximum": 120, "type": "integer", "description": "Seconds between request starts. Leave unset to let the actor choose a light default (0.5s with a proxy, 1.5s without). Flippa's /search page is only mildly rate-limited, so this rarely needs raising." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy. Residential is the default and takes a fresh exit IP per request, which removes any rate limit on very large runs. The /search page is lightly limited, so runs work without a proxy too.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }