API live · v1.0

Otwarte API schronisk dla zwierząt w Polsce

127 schronisk · 16 województw · Licencja CC-BY 4.0

Pobierz dane (JSON) JSON Schema

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:

Endpoint: GET /api/v1/shelters/{wojewodztwo}.json

Wybierz 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

Pokrycie pól w datasecie (5 kategorii) Telefon 99.2% Adres 100% WWW 44.1% Email 15% Geo-koord. 17.3%

Pomóż uzupełnić dziurawe pola, zgłoś korektę.

Co dalej?