Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.1.0
info:
title: Empire Flippers API
version: '2026-11-09'
description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-09: 4 operation(s) read from 2 public documentation page(s) (each operation
names its page in x-source). This is not the provider''s published contract; Empire Flippers has published no machine-readable contract that
the pipeline could find. Engine: local.'
x-evidence-tiers:
code-example: 0
documentation: 4
pages-with-code: 0
pages-read: 2
x-generated-from: documentation
x-provenance: generated
x-authored-by: API Evangelist
x-generated: '2026-11-09'
x-generator: generate-contract-from-docs.py
x-engine: local
x-sources:
- https://empireflippers.com/marketplace-api
- https://empireflippers.com/referral-partner-valuation-tool-api
servers:
- url: https://api.empireflippers.com
paths:
/api/v1/ef-config:
get:
operationId: get_api_v1_ef_config
tags:
- Api
summary: Returns configuration options used within our applications, which includes the current list of niches and monetizations that can
be used to filter listings.
x-source: https://empireflippers.com/marketplace-api
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/api/v1/listings/list:
get:
operationId: get_api_v1_listings_list
tags:
- Api
summary: Returns all listings that are publicly visible on the Empire Flippers marketplace.
x-source: https://empireflippers.com/marketplace-api
parameters:
- name: page
in: query
required: false
schema:
type: string
description: Pagination. The first page is page 1. If no page number is specified then page 1 will be displayed.
- name: limit
in: query
required: false
schema:
type: string
description: The number of listings to be returned. The default is 20 and the maximum is 100.
- name: q
in: query
required: false
schema:
type: string
description: A string that searches the listings with full-text search capability.
- name: sort
in: query
required: false
schema:
type: string
description: 'Can be one of the following: listing_number, average_annual_net_profit, average_annual_gross_revenue, average_annual_expenses,
annual_listing_multiple, annual_sale_multiple, average_monthly_net_profit, average_monthly_gross_revenue, average_monthly_expenses,
listing_multiple, sale_multiple, first_made_money_at, listing_price, first_listing_price, first_listed_at, hours_worked_per_week, inventory_cost,
uses_pbn, seller_interview_link, private_lender_approved, has_trademark, patent_pending, patented_design, patented_utility, amazon_sku_count,
amazon_parent_asin_count, country, country_of_business_registration, last_listed_at, first_delisted_at, last_delisted_at, created_at,
updated_at, sold_at, listing_status, max_monetization, min_monetization, max_niche, min_niche, days_on_marketplace'
- name: order
in: query
required: false
schema:
type: string
description: Either ASC or DESC.
- name: listing_number
in: query
required: false
schema:
type: string
description: Returns just one listing that has this listing number.
- name: listing_price_from
in: query
required: false
schema:
type: string
description: Filters listings with a listing price greater than or equal to this number. Listings are quoted in USD.
- name: listing_price_to
in: query
required: false
schema:
type: string
description: Filters listings with a listing price less than or equal to this number. Listings are quoted in USD.
- name: sold_at_from
in: query
required: false
schema:
type: string
description: Filters listings with a sold date greater than or equal to this date. E.g. 2018-01-01 00:00:00.
- name: sold_at_to
in: query
required: false
schema:
type: string
description: Filters listings with a sold date less than or equal to this date. E.g. 2018-01-01 00:00:00.
- name: created_at_from
in: query
required: false
schema:
type: string
description: Filters listings with a created/listing submitted date greater than or equal to this date. E.g. 2018-01-01 00:00:00.
- name: created_at_to
in: query
required: false
schema:
type: string
description: Filters listings with a created/listing submitted date less than or equal to this date. E.g. 2018-01-01 00:00:00.
- name: average_annual_net_profit_from
in: query
required: false
schema:
type: string
description: Filters listings with an annual net profit greater than or equal to this amount.
- name: average_annual_net_profit_to
in: query
required: false
schema:
type: string
description: Filters listings with an annual net profit less than or equal to this amount.
- name: annual_listing_multiple_from
in: query
required: false
schema:
type: string
description: Filters listings with an annual listing multiple greater than or equal to this number. E.g. 2.5.
- name: annual_listing_multiple_to
in: query
required: false
schema:
type: string
description: Filters listings with an annual listing multiple less than or equal to this number. E.g. 4.5.
- name: average_monthly_net_profit_from
in: query
required: false
schema:
type: string
description: Deprecated in favour of average_annual_net_profit_from . Filters listings with an average monthly net profit greater than
or equal to this amount.
- name: average_monthly_net_profit_to
in: query
required: false
schema:
type: string
description: Deprecated in favour of average_annual_net_profit_to . Filters listings with an average monthly net profit less than or equal
to this amount.
- name: listing_multiple_from
in: query
required: false
schema:
type: string
description: Deprecated in favour of annual_listing_multiple_from . Filters listings with a monthly listing multiple greater than or equal
to this number.
- name: listing_multiple_to
in: query
required: false
schema:
type: string
description: Deprecated in favour of annual_listing_multiple_to . Filters listings with a monthly listing multiple less than or equal
to this number.
- name: first_listed_at_from
in: query
required: false
schema:
type: string
description: Filters listings with a first listed date greater than or equal to this date. E.g. 2018-01-01 00:00:00.
- name: first_listed_at_to
in: query
required: false
schema:
type: string
description: Filters listings with a first listed date less than or equal to this date. E.g. 2018-01-01 00:00:00.
- name: last_listed_at_from
in: query
required: false
schema:
type: string
description: Filters listings with a last listed date greater than or equal to this date. E.g. 2018-01-01 00:00:00.
- name: last_listed_at_to
in: query
required: false
schema:
type: string
description: Filters listings with a last listed date less than or equal to this date. E.g. 2018-01-01 00:00:00.
- name: updated_at_from
in: query
required: false
schema:
type: string
description: Filters listings with a updated at date greater than or equal to this date. E.g. 2018-01-01.
- name: updated_at_to
in: query
required: false
schema:
type: string
description: Filters listings with a updated at date less than or equal to this date. E.g. 2018-01-01 00:00:00.
- name: listing_status
in: query
required: false
schema:
type: string
description: 'Filters listings on status. E.g. “For Sale”, “Sold”.’ '
- name: uses_pbn
in: query
required: false
schema:
type: string
description: Filters listings based on if they use a PBN. Is a boolean, can be true/false.
- name: private_lender_approved
in: query
required: false
schema:
type: string
description: Filters listings based on whether or not they are approved for private lender financing. Is a boolean, can be true/false.
- name: has_trademark
in: query
required: false
schema:
type: string
description: Filters listings based on if they have a trademark. Is a boolean, can be true/false.
- name: has_seller_interview
in: query
required: false
schema:
type: string
description: Filters listings based on if they have a seller interview. Is a boolean, can be true/false.
- name: has_penalties
in: query
required: false
schema:
type: string
description: Filters listings based on if they have penalties. Is a boolean, can be true/false.
- name: first_made_money_at_from
in: query
required: false
schema:
type: string
description: Filters listings with a first made money at date greater than or equal to this date. E.g. 2018-01-01.
- name: first_made_money_at_to
in: query
required: false
schema:
type: string
description: Filters listings with a first made money at date less than or equal to this date. E.g. 2018-01-01.
- name: monetizations
in: query
required: false
schema:
type: string
description: Filters listings by monetizations. Use a double bar “||” to filter by multiple monetizations.
- name: niches
in: query
required: false
schema:
type: string
description: Filters listings by niches. Use a double bar “||” to filter by multiple niches.
- name: countries
in: query
required: false
schema:
type: string
description: Filters listings by country. Use a double bar “||” to filter by multiple countries. E.g. US||UK||AU.
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/api/v1/listings/recommendations:
get:
operationId: get_api_v1_listings_recommendations
tags:
- Api
summary: The recommendations API returns listings that are similar to a specific listing.
x-source: https://empireflippers.com/marketplace-api
parameters:
- name: id
in: query
required: true
schema:
type: string
description: This is our internal UUID for the listing, and is different to the listing_number parameter.
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/api/v1/partner-toolkit/valuation-tool/valuation:
get:
operationId: get_api_v1_partner_toolkit_valuation_tool_valuation
tags:
- Api
summary: Returns a valuation for a given set of input parameters.
x-source: https://empireflippers.com/referral-partner-valuation-tool-api
parameters:
- name: X-Empire-Flippers-API-Key
in: header
required: true
schema:
type: string
description: Your API Key. The API key is found here on the Referral Partner tab in your user profile .
- name: average_annual_net_profit
in: query
required: true
schema:
type: string
description: E.g. 60000 for $60,000 USD in annual profit (revenue minus expenses). Encourage the user to give the total over the last
12 months, if possible, for the most accurate valuation.
- name: average_monthly_net_profit
in: query
required: false
schema:
type: string
description: Deprecated in favour of average_annual_net_profit . E.g. 5000 for $5000 USD in average monthly profit (revenue minus expenses).
- name: average_monthly_gross_revenue
in: query
required: false
schema:
type: string
description: Deprecated in favour of average_annual_gross_revenue . The average of sales per month over the last 12 months.
- name: monetization
in: query
required: false
schema:
type: string
description: 'Valid options include: Affiliate, Agency, Amazon Associates, Amazon FBA, Amazon FBM, Amazon KDP, Amazon Merch, Application,
Digital Product, Display Advertising, DropShipping, eCommerce, Info Product, Lead Gen, Newsletter, SaaS, Service, Subscription, Subscription-Box,
Youtube. Please URL encode spaces as %20 when passing as a parameter.'
- name: business_created_at
in: query
required: false
schema:
type: string
description: Date when the business first started operations. Valid format is YYYY-MM-DD.
- name: debug_mode
in: query
required: false
schema:
type: string
description: When true , the API will return an error if an incorrect parameter is sent for a given monetization and is used for debugging.
When false , the incorrect parameter will simply be ignored. Defaults to false when not provided in the query.
- name: social_media_followers
in: query
required: false
schema:
type: string
description: How many social media followers (across all social networks) the business has.
- name: unique_users
in: query
required: false
schema:
type: string
description: The average number of people that visit the business’s website each month.
- name: email_subscribers
in: query
required: false
schema:
type: string
description: The total number of customer email contacts who have subscribed to receive marketing emails from the business.
- name: number_of_products
in: query
required: false
schema:
type: string
description: The number of different products that the business sells.
- name: number_of_paid_subscribers
in: query
required: false
schema:
type: string
description: The number of customers paying for a subscription from the business.
- name: number_of_revenue_channels
in: query
required: false
schema:
type: string
description: The number of separate revenue channels (e.g. affiliate programs/offers, ad networks, etc.) that the business uses to make
money.
- name: active_customers
in: query
required: false
schema:
type: string
description: The number of currently active customers that the business has.
- name: number_of_downloads
in: query
required: false
schema:
type: string
description: How many downloads from the app stores that your app has received.
- name: saas_model
in: query
required: false
schema:
type: string
description: 'Valid options include: MRR only, ARR only, Both, None. Please URL encode spaces as %20 when passing as a parameter.'
- name: first_subscriber_at
in: query
required: false
schema:
type: string
description: Date when the business acquired their first paying subscriber. Valid format is YYYY-MM-DD.
- name: mrr_now
in: query
required: false
schema:
type: string
description: Current amount of Monthly Recurring Revenue in USD. Exclude any one-time, lifetime, or service-based revenue.
- name: mrr_3_months_ago
in: query
required: false
schema:
type: string
description: Monthly Recurring Revenue in USD from 3 months ago. Exclude any one-time, lifetime, or service-based revenue.
- name: mrr_12_months_ago
in: query
required: false
schema:
type: string
description: Monthly Recurring Revenue in USD from 12 months ago (input 0 for none). Exclude any one-time, lifetime, or service-based
revenue.
- name: average_monthly_net_profit_3_months
in: query
required: false
schema:
type: string
description: Average monthly net profit from 3 months ago. This SaaS-specific figure stays monthly.
- name: average_monthly_net_profit_6_months
in: query
required: false
schema:
type: string
description: Average monthly net profit from 6 months ago. This SaaS-specific figure stays monthly.
- name: average_monthly_churn_percent
in: query
required: false
schema:
type: string
description: E.g. 5 for 5% monthly churn. If this value isn’t known via SaaS analytics software, it can be estimated by dividing 1 by
the business’s average customer subscription length.
- name: has_team
in: query
required: false
schema:
type: string
description: Whether the business has staff or contractors working on it beyond the owner.
- name: hours_worked_per_week
in: query
required: false
schema:
type: string
description: How many hours per week the owner works on the business.
- name: average_annual_gross_revenue
in: query
required: false
schema:
type: string
description: Total sales over the last 12 months.
- name: revenue_trend
in: query
required: false
schema:
type: string
description: 'Valid options include: steady, increasing, decreasing.'
- name: revenue_diversity
in: query
required: false
schema:
type: string
description: 'Valid options include: Above 40%, 20-40%, Less than 20%.'
- name: recurring_revenue
in: query
required: false
schema:
type: string
description: 'Valid options include: One-time Revenue, Recurring Revenue, Mixed One-time and Recurring Revenue.'
- name: client_acquisition
in: query
required: false
schema:
type: string
description: 'Valid options include: Yes, No.'
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetApiV1PartnerToolkitValuationToolValuationResponse'
x-evidence:
kind: documentation
components:
schemas:
GetApiV1PartnerToolkitValuationToolValuationResponse:
type: object
properties:
data:
type: object
description: Contains valuation multiples and values.
data.absolute_low_multiple:
type: number
description: Deprecated. The monthly equivalent of annual_absolute_low_multiple.
data.typical_low_multiple:
type: number
description: Deprecated. The monthly equivalent of annual_typical_low_multiple.
data.suggested_listing_multiple:
type: number
description: Deprecated. The monthly equivalent of annual_suggested_listing_multiple.
data.typical_high_multiple:
type: number
description: Deprecated. The monthly equivalent of annual_typical_high_multiple.
data.absolute_high_multiple:
type: number
description: Deprecated. The monthly equivalent of annual_absolute_high_multiple.
data.annual_absolute_low_multiple:
type: number
description: The absolute lowest multiple that Empire Flippers recommends you list your business for.
data.annual_typical_low_multiple:
type: number
description: The generally recommended lowest multiple that Empire Flippers recommends you list your business for.
data.annual_suggested_listing_multiple:
type: number
description: What Empire Flippers suggests as the multiple to list your business for sale at.
data.annual_typical_high_multiple:
type: number
description: The generally recommended highest multiple that Empire Flippers recommends you list your business for.
data.annual_absolute_high_multiple:
type: number
description: The absolute highest multiple that Empire Flippers recommends you list your business for.
data.absolute_low_valuation:
type: integer
description: The absolute lowest valuation that Empire Flippers recommends you list your business for.
data.typical_low_valuation:
type: integer
description: The generally recommended lowest valuation that Empire Flippers recommends you list your business for.
data.suggested_listing_price:
type: integer
description: The generally recommended highest valuation that Empire Flippers recommends you list your business for.
data.typical_high_valuation:
type: integer
description: The generally recommended highest valuation that Empire Flippers recommends you list your business for.
data.absolute_high_valuation:
type: integer
description: The absolute highest valuation that Empire Flippers recommends you list your business for.
data.is_profit_multiple:
type: boolean
description: For SaaS businesses they can be valued using a multiple of their profit (true) or monthly recurring revenue (false). All
other monetization will always be profit multiples (true).
errors:
type: array
description: Array of error messages if the request fails.
tags:
- name: Api