nexxt-change APInexxt-change.org ↗
Access German business sale listings, buyer requests, and regional partner data from nexxt-change.org via 7 structured endpoints with filters for sector, state, and keyword.
What is the nexxt-change API?
The nexxt-change.org API exposes 7 endpoints covering company sale listings, buyer/investor requests, and regional succession support partners from Germany's business succession marketplace. Use search_sale_listings to query Verkaufsangebote by keyword, sector, or Bundesland, then fetch full metadata — including employee count, revenue, and asking price — via get_sale_listing_detail. All three listing types follow a consistent search-then-detail pattern.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/23ccf41c-12b2-4527-9e3d-b7c9f7d8cd00/get_sector_options' \ -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 nexxt-change-org-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: nexxt-change.org SDK — German business succession marketplace."""
from parse_apis.nexxt_change_org_API import NexxtChange, NotFoundError
client = NexxtChange()
# List available sector options for filtering sale listings
for sector in client.sector_options.list(limit=5):
print(sector.label, sector.value)
# Search sale listings in the construction sector
listing = client.sale_listing_summaries.search(sector="[1]", limit=1).first()
if listing:
print(listing.id, listing.title, listing.date)
# Drill down into full listing details
detail = listing.details()
print(detail.title, detail.description[:100])
print(detail.details)
# Search buy requests (investors seeking companies)
for req in client.buy_request_summaries.search(limit=3):
print(req.id, req.title, req.date)
# Get full details of a buy request with error handling
if listing:
try:
full = client.sale_listing_summaries.search(query="Restaurant", limit=1).first()
if full:
info = full.details()
print(info.title, info.details)
except NotFoundError as exc:
print(f"Listing not found: {exc}")
# Search regional partners (IHKs, chambers of commerce)
for partner in client.regional_partner_summaries.search(query="IHK", limit=3):
print(partner.id, partner.title, partner.link)
full_partner = partner.details()
print(full_partner.title, full_partner.contact_info[:80])
print("exercised: sector_options.list / sale_listing_summaries.search / details / buy_request_summaries.search / regional_partner_summaries.search / partner.details")
Get the hierarchical list of sectors (Branchen) available for filtering sale listing searches. Each option has a human-readable label and a bracket-encoded value string that can be passed as the sector parameter to search_sale_listings. The list is static and reflects the site's NACE-based classification tree.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of sector option objects, each with label (human-readable name) and value (bracket-encoded filter string)"
},
"sample": {
"data": {
"items": [
{
"label": "Baugewerbe > Alle Rubriken",
"value": "[1]"
},
{
"label": "Gastgewerbe > Gastronomie",
"value": "[4,24]"
}
]
},
"status": "success"
}
}About the nexxt-change API
Sale Listings and Buyer Requests
The two core listing types are Verkaufsangebote (companies for sale) and Kaufgesuche (buyer/investor requests). search_sale_listings accepts up to four filter parameters — page, query, sector, and bundesland — and returns paginated results with id, title, date, location, description, and tags, plus a total count. Sector values are bracket-encoded strings (e.g. [4,24]) retrieved from get_sector_options, which returns the full hierarchical Branchen list. get_sale_listing_detail resolves a listing id into structured details fields: Chiffre, Standort, Branche, Anzahl Mitarbeiter, Letzter Jahresumsatz, and Preisvorstellung. search_buy_requests and get_buy_request_detail follow the same pattern for investor listings, with detail fields covering Inseratstyp, target Standort, Branche, and Preisvorstellung.
Regional Partners
search_regional_partners finds IHKs, Handwerkskammern, and other chamber organizations that facilitate succession processes. It accepts query (city or partner name) and bundesland filters, returning summary objects with id, title, location, and description. get_regional_partner_detail retrieves the full profile, including a contact_info string with address, phone, email, and website, plus any structured details metadata.
Filters and Pagination
Region filtering uses the same bracket-encoded bundesland parameter across all three search endpoints, making it straightforward to scope queries to a single German state. Sale listing search supports page (1-based integer) for walking through result sets; the total field in each search response indicates how many records match. Sector filtering is exclusive to search_sale_listings and requires values from get_sector_options — attempting arbitrary strings will not match valid categories.
The nexxt-change API is a managed, monitored endpoint for nexxt-change.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nexxt-change.org 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 nexxt-change.org 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?+
- Build a deal-sourcing dashboard filtering German SME sale listings by sector and Bundesland using search_sale_listings
- Monitor new Verkaufsangebote in a target industry by polling search_sale_listings with a sector value from get_sector_options
- Match buyers to sellers by cross-referencing search_buy_requests and search_sale_listings on overlapping Branche and location fields
- Enrich a CRM with structured company data (employee count, revenue, asking price) via get_sale_listing_detail
- Generate a regional map of IHK and Handwerkskammer contacts using search_regional_partners filtered by bundesland
- Feed a succession advisory platform with live buyer intent signals from get_buy_request_detail fields like Inseratstyp and Preisvorstellung
| 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 nexxt-change.org have an official developer API?+
What does get_sale_listing_detail return beyond the search summary?+
details object with the listing's Chiffre (reference code), Standort (location), Branche (sector), Anzahl Mitarbeiter (employee count), Letzter Jahresumsatz (last annual revenue), and Preisvorstellung (asking price), plus the full description text. The search endpoint returns only a short excerpt and basic metadata.How do sector filters work in search_sale_listings?+
[1] or [4,24]. You must retrieve valid values from get_sector_options first; the endpoint returns the complete list with human-readable labels paired to their filter strings. Sector filtering is not available on search_buy_requests or search_regional_partners.