Bredbandsval APIbredbandsval.se ↗
Search Swedish broadband offers by address, compare ISPs, and retrieve provider details via the Bredbandsval.se API. 5 endpoints covering addresses, offers, and providers.
What is the Bredbandsval API?
The Bredbandsval.se API gives developers access to 5 endpoints covering Swedish broadband offer discovery: search addresses with search_address_autocomplete, retrieve available plans for a specific street address via get_broadband_offers_by_address, and pull structured data on all ISPs through get_all_providers. Each broadband offer result includes company logo, product details, and property type, making it straightforward to build address-level ISP comparison tools for the Swedish market.
curl -X GET 'https://api.parse.bot/scraper/9485b7a8-4067-40fe-b61d-d5e096068ad6/search_address_autocomplete?query=Vasagatan' \ -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 bredbandsval-se-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: Bredbandsval SDK — search addresses, compare broadband offers, browse providers."""
from parse_apis.bredbandsval_se_api import Bredbandsval, Sort, ProviderNotFound
client = Bredbandsval()
# Search for addresses matching a street name
for addr in client.addresses.search(query="Vasagatan", limit=5):
print(addr.name, addr.street, addr.city)
# Get broadband offers for a specific address
result = client.broadbandsearches.create(
street="Vasagatan", number="1", zip_code="50630", city="Borås"
)
print(result.session_uuid, result.customer_type, len(result.offers))
for offer in result.offers[:3]:
print(offer.company_id, offer.product.name, offer.product.contract_months)
# List providers sorted alphabetically
for provider in client.providers.list(sort=Sort.ALPHABETICAL, limit=5):
print(provider.name, provider.slug, provider.has_broadband)
# Fetch a specific provider by slug with typed error handling
try:
detail = client.providers.get(slug="telia")
print(detail.name, detail.meta_description, detail.has_tv)
except ProviderNotFound as exc:
print(f"Provider not found: {exc.slug}")
# List featured homepage brands
for brand in client.brands.list(limit=5):
print(brand.name, brand.logo_url)
print("exercised: addresses.search / broadbandsearches.create / providers.list / providers.get / brands.list")
Search for Swedish street addresses to use in broadband offer lookups. Returns matching addresses with street name, city, and substring match highlighting. The API returns up to 10 results for any given query prefix. Intended as an autocomplete source: pass a partial street name or city and get candidates back.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Address search query — a partial or full street name, optionally with city (e.g. 'Vasagatan', 'Kungsgatan Stockholm'). |
{
"type": "object",
"fields": {
"addresses": "array of address objects each containing name, street, city, and substringMatchData"
},
"sample": {
"data": {
"addresses": [
{
"city": "Borås",
"name": "Vasagatan, Borås",
"street": "Vasagatan",
"substringMatchData": [
{
"isMatched": true,
"substring": "Vasagatan"
},
{
"isMatched": false,
"substring": ", Borås"
}
]
}
]
},
"status": "success"
}
}About the Bredbandsval API
Address Search and Offer Retrieval
Start with search_address_autocomplete to resolve a user's input into a validated Swedish address. Pass any partial street name or city and receive an array of address objects, each containing name, street, city, and substringMatchData for highlighting matches in a UI. Once you have a confirmed address, call get_broadband_offers_by_address with the required street, number, zip_code, and city parameters (plus optional entrance). The response includes an offers array with companyId, companyLogoUrl, and product details; a companies array summarising how many offers each ISP provides; and metadata like sessionUUID, createdAt, and customerType. Note that this endpoint polls until results are ready and may take up to 30 seconds to respond.
Provider Directory
get_all_providers returns every ISP on the platform as structured objects including name, id, slug, logo, metaTitle, metaDescription, and boolean service flags: hasBroadband, hasMobileBroadband, and hasTV. Pass sort=alphabetical to receive providers in alphabetical name order. The slugs returned here are the input required by get_provider_detail, which returns a richer single-provider record adding headings, hasTelephone, and metaDescription fields useful for rendering a full provider profile page.
Homepage Brands
get_homepage_brands returns the featured ISP brands displayed on the bredbandsval.se homepage, each as a name and logo_url pair. This endpoint takes no inputs and is useful for populating a quick-select ISP picker or checking which providers are currently promoted on the platform.
The Bredbandsval API is a managed, monitored endpoint for bredbandsval.se — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when bredbandsval.se 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 bredbandsval.se 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 an address-level broadband comparison widget for Swedish residential properties using
get_broadband_offers_by_address - Populate a provider directory page with ISP names, logos, and service type flags from
get_all_providers - Implement an address autocomplete input using
search_address_autocompletebefore triggering an offer search - Display a full ISP profile page using the
headings,metaDescription, and capability booleans fromget_provider_detail - Show a curated ISP logo carousel using brand names and logo URLs from
get_homepage_brands - Filter Swedish ISPs by mobile broadband or TV capability using the
hasMobileBroadbandandhasTVflags inget_all_providers
| 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 bredbandsval.se have an official developer API?+
What does `get_broadband_offers_by_address` actually return per offer?+
offers array includes a companyId, companyLogoUrl, and product details for that specific address. The response also includes an address object confirming the matched property (street, number, entrance, zipCode, city, propertyType) and a companies array summarising the count of offers per ISP.Does the API cover business/commercial address searches, or only residential?+
customerType field in offer responses returns values such as consumer, and the address input parameters do not include a business-specific flag. Commercial or business customer searches are not explicitly covered. You can fork this API on Parse and revise it to add a business-focused offer endpoint if that parameter is available.Can I retrieve individual offer pricing or speed tiers from the broadband results?+
get_broadband_offers_by_address includes product details within each offer object, but specific fields like monthly price or download speed are not listed as named fields in the current spec. The offers array contains the available product data returned for the address. You can fork this API on Parse and revise it to surface or flatten additional product detail fields if they appear in the raw response.Is broadband availability data limited to Sweden?+
zip_code parameter expects a 5-digit Swedish postal code, and search_address_autocomplete returns Swedish addresses only. Coverage outside Sweden is not provided.