# Sverigesmiljomal — 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.

> Access Sweden's environmental quality objectives (miljökvalitetsmål) and associated indicators from sverigesmiljomal.se. Retrieve national and regional data on gravel production, environmental indicators, groundwater goals, and annual follow-up reports. Supports time-series analysis across all 21 Swedish counties and all official environmental goal categories.

**Category:** Government & Public Data | **Website:** [sverigesmiljomal.se/](https://sverigesmiljomal.se/) | **Docs:** [parse.bot/marketplace/80704a86-a34e-447e-827d-b5d7a4e4dd8c/sverigesmiljomal-se-api](https://parse.bot/marketplace/80704a86-a34e-447e-827d-b5d7a4e4dd8c/sverigesmiljomal-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-sverigesmiljomal-se-api-80704a86/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_annual_followup

Retrieves the latest annual review report summary from the fakta-och-statistik page. Returns summary text describing the annual environmental goals follow-up and the source page URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_annual_followup \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_gravel_share_map_data

Retrieves map data showing the percentage share of natural gravel per county. Uses Highcharts map codes (e.g. 'se-st' for Stockholm) for county identification. Returns series with [map_code, percentage] pairs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_gravel_share_map_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_gravel_usage_by_application_national

Retrieves natural gravel extraction broken down by usage area at the national level. Returns time-series for application categories including Betong, Väg, Fyllnad, and Övrigt in millions of tonnes.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_gravel_usage_by_application_national \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_gravel_usage_by_region_snapshot

Retrieves a snapshot of natural gravel usage by region for the most recent available year. Returns usage in thousands of tonnes broken down by application for each of the 21 Swedish counties.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_gravel_usage_by_region_snapshot \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_groundwater_goal_overview

Retrieves the 'Grundvatten av god kvalitet' (Good Quality Groundwater) environmental goal overview page. Returns the goal name and its related indicators. Assessment status and definition may be empty if not rendered in the current page HTML.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_groundwater_goal_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_indicator_detail

Extracts all Highcharts chart configurations from any indicator page. Returns chart titles, subtitles, series data, and axis categories for every chart embedded in the page. Supports both absolute and relative URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Absolute or relative URL of the indicator page. Examples: 'https://sverigesmiljomal.se/miljomalen/grundvatten-av-god-kvalitet/grusanvandning/' or '/miljomalen/begransad-klimatpaverkan/klimatpaverkande-utslapp/'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_indicator_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_indicator_download_data

Retrieves chart data for an indicator in a structured format suitable for data export. Functionally equivalent to get_indicator_detail — extracts all Highcharts chart data from the indicator page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Absolute or relative URL of the indicator page, e.g. 'https://sverigesmiljomal.se/miljomalen/grundvatten-av-god-kvalitet/grusanvandning/'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_indicator_download_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_indicator_regional_detail

Retrieves regional data for an indicator that supports county-level breakdown. Returns chart data for the specified county. Not all indicators support regional data — for unsupported indicators, the data array will be empty.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `county_slug` | string | Yes | County slug, e.g. 'stockholms-lan', 'skane-lan', 'vasterbottens-lan'. |
| `goal_slug` | string | Yes | Goal slug, e.g. 'grundvatten-av-god-kvalitet', 'begransad-klimatpaverkan'. |
| `indicator_slug` | string | Yes | Indicator slug, e.g. 'grusanvandning', 'klimatpaverkande-utslapp'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_indicator_regional_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"county_slug":"<string>","goal_slug":"<string>","indicator_slug":"<string>"}'
```

### get_national_gravel_production

Retrieves national-level gravel production time-series data from the Grusanvändning indicator page. Returns annual delivered quantities for Naturgrus, Krossberg, and Morän in millions of tonnes as [year, value] pairs. One chart object with title, subtitle (Sverige), and series array.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_national_gravel_production \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_regional_gravel_production

Retrieves gravel production data for a specific Swedish county (Län). Returns annual time-series of delivered quantities for Krossberg, Morän, and Naturgrus in thousands of tonnes. The county is specified by its URL slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `county_slug` | string | Yes | County slug as used in the site URL path. Values include: 'stockholms-lan', 'skane-lan', 'vasterbottens-lan', 'vastra-gotalands-lan', 'norrbottens-lan', 'hallands-lan', 'dalarnas-lan', 'jamtlands-lan', 'gavleborgs-lan', 'kronobergs-lan', 'jonkopings-lan', 'kalmar-lan', 'blekinge-lan', 'gotlands-lan', 'sodermanlands-lan', 'ostergotlands-lan', 'orebro-lan', 'vastmanlands-lan', 'varmlands-lan', 'vasternorrlands-lan', 'uppsala-lan'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/get_regional_gravel_production \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"county_slug":"<string>"}'
```

### list_all_indicators

Lists all environmental indicators from the indicators index page. Each indicator includes its name, full URL, parent goal slug, and its own indicator slug. Useful for discovering available indicators and their slugs for use with other endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/list_all_indicators \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_environmental_goals

Lists Swedish environmental quality objectives from the miljömålen page. Returns 17 goals (Generationsmålet plus 16 environmental quality objectives) with their names, full URLs, and URL slugs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/list_environmental_goals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_indicators_for_goal

Lists indicators associated with a specific environmental goal by filtering the full indicators list. Returns only indicators whose goal_slug matches the provided value. Use list_all_indicators or list_environmental_goals to discover valid goal slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `goal_slug` | string | Yes | Goal slug from list_environmental_goals results or list_all_indicators results. Examples: 'grundvatten-av-god-kvalitet', 'begransad-klimatpaverkan', 'frisk-luft', 'giftfri-miljo', 'generationsmalet'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sverigesmiljomal-se-api-80704a86/list_indicators_for_goal \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"goal_slug":"<string>"}'
```