# Bredbandsval — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for available broadband offers at any Swedish address and compare internet service providers to find the best plan for your location. Browse all ISP providers, view detailed information about each one, and access their homepage brands in one place.

**Category:** Business Directories | **Website:** [bredbandsval.se/](https://bredbandsval.se/) | **Docs:** [parse.bot/marketplace/79febe6e-60e3-4cba-bc53-7aa15ac441e3/bredbandsval-se-api](https://parse.bot/marketplace/79febe6e-60e3-4cba-bc53-7aa15ac441e3/bredbandsval-se-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-bredbandsval-se-api-79febe6e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_providers

List all internet service providers on the platform. Returns detailed provider objects including name, slug, logo, meta descriptions, content headings, and boolean flags for service capabilities (broadband, mobile broadband, TV, telephone). Supports alphabetical sorting.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sort` | string | No | Sort order for the provider list. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bredbandsval-se-api-79febe6e/get_all_providers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sort":"<string>"}'
```

### get_broadband_offers_by_address

Get available broadband offers for a specific Swedish address. Internally creates a search session, polls for completion (up to 30 seconds), and returns the full result including matched companies and their offer details. Each offer contains product info, pricing tiers, speed, and contract length.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name (e.g. 'Borås'). |
| `entrance` | string | No | Entrance identifier when the address has multiple entrances (e.g. 'A', 'B'). Omit or pass empty string when not applicable. |
| `number` | string | Yes | Street number (e.g. '1', '12'). |
| `street` | string | Yes | Street name (e.g. 'Vasagatan'). |
| `zip_code` | string | Yes | Swedish 5-digit postal code (e.g. '50630'). Leading zeros are not expected for Swedish codes (range 10000–99999). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bredbandsval-se-api-79febe6e/get_broadband_offers_by_address \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","entrance":"<string>","number":"<string>","street":"<string>","zip_code":"<string>"}'
```

### get_homepage_brands

Get the featured brand logos displayed on the homepage. Returns a list of provider names paired with their logo image URLs. Useful for discovering which providers are currently promoted.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bredbandsval-se-api-79febe6e/get_homepage_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_provider_detail

Get detailed information for a specific provider by its URL slug. Returns the full provider object including name, logo, meta descriptions, content section headings, and boolean service capability flags. Use slugs obtained from get_all_providers results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Provider slug identifier (e.g. 'telia', 'telenor', 'bredband2'). Obtain from get_all_providers results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bredbandsval-se-api-79febe6e/get_provider_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### search_address_autocomplete

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Address search query — a partial or full street name, optionally with city (e.g. 'Vasagatan', 'Kungsgatan Stockholm'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bredbandsval-se-api-79febe6e/search_address_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```