API-dokumentation

Öppet REST API för återvinningsdata i Sverige. Gratis att använda.

Base URL
https://sopinfo.se/api
Format
JSON (UTF-8)
Autentisering
Ingen krävs

Översikt

sopinfo.se erbjuder ett öppet REST API för att hämta data om återvinning i Sverige. API:et innehåller information om:

  • 290 kommuner - befolkningsdata, län, och antal stationer
  • 4 500+ återvinningsstationer - ÅVC och återvinningsstationer med koordinater, adresser och öppettider
  • 20 sorteringsguide-artiklar - information om hur man sorterar olika typer av avfall

API:et körs på Cloudflare Workers med D1 (SQLite) databas för snabb global respons.

Rate Limiting

Cloudflare Workers har en generös gratisplan. Vi ber dig hålla förfrågningar under 1000 requests/minut för att säkerställa tillgänglighet för alla. Vid missbruk kan IP-blockering tillämpas.

Snabblänkar till endpoints

Health CheckStatistikLista kommunerHämta kommunLista stationerHämta stationLista sorteringsguideHämta sorteringsartikel

Endpoints

GET/api/health

Health Check

Kontrollera API-status och databasanslutning.

GET/api/counts

Statistik

Hämta antal poster i alla tabeller.

GET/api/kommuner

Lista kommuner

Hämta lista över alla Sveriges kommuner med återvinningsinformation.

GET/api/kommuner/:slug

Hämta kommun

Hämta detaljer för en specifik kommun inklusive alla stationer.

GET/api/stationer

Lista stationer

Hämta lista över alla återvinningsstationer i Sverige.

GET/api/stationer/:id

Hämta station

Hämta detaljer för en specifik återvinningsstation.

GET/api/sorteringsguide

Lista sorteringsguide

Hämta alla sorteringsguide-artiklar med information om hur olika avfall ska sorteras.

GET/api/sorteringsguide/:slug

Hämta sorteringsartikel

Hämta en specifik sorteringsguide-artikel.

Användningsexempel

JavaScript (fetch)

// Hämta alla kommuner
const response = await fetch('https://sopinfo.se/api/kommuner?limit=290');
const data = await response.json();
console.log(data.data); // Array med kommuner

Python (requests)

import requests

# Hämta stationer i en kommun
response = requests.get('https://sopinfo.se/api/kommuner/stockholm')
data = response.json()
print(f"Antal stationer: {len(data['stationer'])}")

cURL

# Sök sorteringsguide
curl "https://sopinfo.se/api/sorteringsguide?search=plast"

Har du frågor?

Kontakta oss om du har frågor om API:et eller vill rapportera problem.

Läs mer om sopinfo.se