Mergernetwork APImergernetwork.com ↗
Search and retrieve business-for-sale, real estate, funding, and financial asset listings from DealStream via 13 structured endpoints with financials and contact data.
What is the Mergernetwork API?
The DealStream API exposes 13 endpoints covering business-for-sale listings, commercial real estate, land, leased space, funding opportunities, oil and gas properties, and financial assets. The search_businesses_for_sale endpoint returns paginated results filtered by keyword, price range, and industry category slug, while get_business_listing_detail delivers structured financials, location breakdowns, and full descriptions for individual listings.
curl -X GET 'https://api.parse.bot/scraper/786374ad-ff82-46ab-b266-b0d1d1e9cb8b/search_businesses_for_sale?page=1&query=restaurant' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace mergernetwork-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: DealStream SDK — search listings, drill into details, browse categories."""
from parse_apis.dealstream_api import DealStream, ListingDetail, ListingNotFound
client = DealStream()
# Browse newest business listings — single-page fetch, capped
for listing in client.listings.new_arrivals(limit=3):
print(listing.title, listing.price, listing.currency)
# Search by location and drill into the first result's full detail
florida_listing = client.listings.by_location(location_slug="florida-businesses-for-sale", limit=1).first()
if florida_listing:
detail = florida_listing.details()
print(detail.title, detail.industry, detail.financials)
# Search oil & gas listings with a keyword
for oil in client.listings.oil_gas(query="production", limit=3):
print(oil.title, oil.price, oil.location.country)
# Typed error handling on detail fetch
try:
bad = client.listings.search(query="nonexistent", limit=1).first()
if bad:
bad.details()
except ListingNotFound as exc:
print(f"Listing gone: {exc.url}")
# Discover available categories
for cat in client.categories.list(limit=5):
print(cat.name, cat.slug)
print("exercised: listings.new_arrivals / listings.by_location / details / listings.oil_gas / listings.search / categories.list")
Search for businesses for sale with filters for keyword, price, and category. Returns paginated results with up to 25 listings per page. Omitting all filters returns all businesses for sale.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| query | string | Search keyword to filter listings. |
| price_max | integer | Maximum asking price filter. |
| price_min | integer | Minimum asking price filter. |
| category_slug | string | Category path slug to filter by (e.g. /health-care-businesses-for-sale). Available slugs can be retrieved from list_business_categories. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"listings": "array of listing objects with id, title, url, description, price, currency, location, and image",
"total_found": "integer, number of listings returned on this page"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"id": "runvps",
"url": "https://dealstream.com/d/biz-sale/finance-cos/runvps",
"image": "https://dealstream.com/assets/images/listingicons/png/fak fa-ds-finance.png",
"price": 250000,
"title": "Swiss Financial Services & Payments Company - DealStream",
"currency": "CHF",
"location": {
"region": "Zurich",
"country": "CH",
"locality": "Zurich"
},
"description": "Overview Fully operational Swiss-based fintech company for sale."
}
],
"total_found": 25
},
"status": "success"
}
}About the Mergernetwork API
What the API Covers
The DealStream API gives programmatic access to listing data across six distinct verticals: businesses for sale, commercial real estate, land, space for lease, funding wanted, and financial assets (including shelf companies and public shells). Specialized endpoints cover oil and gas properties (search_oil_gas_listings) and buyer-side "Wanted" postings (search_wanted_listings). All search endpoints return paginated arrays of listing objects containing id, title, url, description, price, currency, location, and image, with up to 25 results per page.
Filtering and Discovery
search_businesses_for_sale accepts query, price_min, price_max, and category_slug parameters. Valid category_slug values — for example /health-care-businesses-for-sale — are discoverable via list_business_categories, which also returns location slugs used by search_businesses_by_location. Location slugs follow the pattern florida-businesses-for-sale or california-businesses-for-sale. get_new_arrivals returns the most recently posted listings without any filter inputs.
Detail and Contact Endpoints
get_business_listing_detail accepts a URL path from any search result and returns structured fields including industry, a location object with country, region, and locality, a financials object with asking_price and related fields, plus description and full_description when available. get_listing_contact_info takes the same URL path format and returns broker or seller name and phone. These two endpoints together are the primary path to actionable deal intelligence from a search result.
The Mergernetwork API is a managed, monitored endpoint for mergernetwork.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mergernetwork.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official mergernetwork.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen acquisition targets by filtering
search_businesses_for_saleresults byprice_min,price_max, andcategory_slugto match a specific buy-side mandate. - Aggregate new deal flow automatically by polling
get_new_arrivalsand pushing results to a deal-tracking spreadsheet or CRM. - Build a geographic market map of businesses for sale by iterating location slugs through
search_businesses_by_location. - Pull full financial details on shortlisted businesses using
get_business_listing_detailto surfaceasking_priceand industry classification. - Identify investors seeking capital by querying
search_funding_wantedfor businesses actively looking for funding. - Compile broker contact lists for outbound campaigns using
get_listing_contact_infoagainst a batch of listing URLs. - Monitor specialized asset categories — oil and gas royalties, shelf companies, public shells — via
search_oil_gas_listingsandsearch_financial_assets.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does DealStream (MergerNetwork) have an official developer API?+
What does `get_business_listing_detail` return that search results do not?+
get_business_listing_detail returns a financials object with structured asking price and location data, a full_description field (the complete listing body text), an industry classification string, and a structured location object with country, region, and locality. Search result listing objects include only a short description, price, currency, location, and image.Does `total_found` on search endpoints reflect the total listings in the database or just the current page?+
total_found returns the count of listings on the current page, not the overall database total matching your query. To determine total result depth, you need to paginate using the page parameter and observe when the returned count drops or the listings array is empty.Does the API return historical or sold listings, or only active ones?+
Can I filter real estate, land, or lease searches by price or location the same way I can for business listings?+
search_real_estate_listings, search_land_for_sale, and search_space_for_lease currently accept only page and query parameters — not price_min, price_max, or location_slug. Those filters are only available on search_businesses_for_sale and search_businesses_by_location. You can fork this API on Parse and revise it to add price and location filter parameters to the real estate and land endpoints.