API live · v1.0
Otwarte API schronisk dla zwierząt w Polsce
127 schronisk · 16 województw · Licencja CC-BY 4.0
Po co to API?
Polskie schroniska dla zwierząt walczą o widoczność. Nie ma centralnej bazy ich danych, każde schronisko żyje na własnej (często niewidocznej) stronie, w przepisach gminnych, w dokumentach WIW.
Ten dataset to próba zmiany. Otwarte API, darmowe, bez kont, bez kluczy. Każdy programista może w 5 minut zbudować apkę pomagającą znaleźć schronisko w swojej okolicy. Każdy dziennikarz może zacytować dane bez pytania nikogo o pozwolenie. Każdy aktywista może analizować pokrycie regionów i kierować pomoc tam, gdzie najbardziej potrzeba.
Im więcej osób tych danych użyje, tym więcej psów i kotów znajdzie dom.
Wypróbuj API teraz
Wybierz województwo aby zobaczyć przykładową odpowiedź, bez kont, bez kluczy, bez setupu:
GET /api/v1/shelters/{wojewodztwo}.jsonWybierz województwo aby zobaczyć odpowiedź API.
Jak zacząć
Skopiuj jeden z 4 snippetów i jesteś gotowy:
# Pobierz wszystkie schroniska + filtruj po mieście
curl https://otwarteschroniska.org.pl/api/v1/shelters.json | jq '.[] | select(.miasto == "Wrocław")'// W przeglądarce / Node 18+
const r = await fetch('https://otwarteschroniska.org.pl/api/v1/shelters.json');
const shelters = await r.json();
console.log(`Łącznie: ${shelters.length} schronisk`);# Wymaga: pip install requests
import requests
shelters = requests.get('https://otwarteschroniska.org.pl/api/v1/shelters.json').json()
print(f"Łącznie: {len(shelters)} schronisk")
# Filtruj te z emailem:
with_email = [s for s in shelters if s.get('email')]// Node.js 20+ (built-in fetch)
const r = await fetch('https://otwarteschroniska.org.pl/api/v1/shelters.json');
const data = await r.json();
const byWoj = data.reduce((acc, s) => {
acc[s.wojewodztwo] = (acc[s.wojewodztwo] || 0) + 1;
return acc;
}, {});
console.table(byWoj);Pokrycie danych
Pomóż uzupełnić dziurawe pola, zgłoś korektę.