# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/bredbandsval/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/bredbandsval/get-all-providers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bredbandsval/get-broadband-offers-by-address \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bredbandsval/get-homepage-brands \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bredbandsval/get-provider-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bredbandsval/search-address-autocomplete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.