Spheriq APIapp.spheriq.ch ↗
Search and browse Swiss foundations, non-profit organizations, and their projects through an organized database, filtering by category and reading detailed descriptions to find organizations aligned with your interests. Discover charitable entities and their initiatives across Switzerland all in one searchable platform.
curl -X GET 'https://api.parse.bot/scraper/a1c4bf29-d82d-4487-b46a-30ea8d32cc53/search_organizations?page=0&query=stiftung&hits_per_page=20&form_of_impact=grant_giving_organization' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace app-spheriq-ch-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Spheriq SDK — bounded, re-runnable; every call capped."""
from parse_apis.app_spheriq_ch_api import Spheriq, FormOfImpact, InvalidInput
client = Spheriq()
# Search for foundations matching "kultur" (culture), limited to 3 results
for org in client.organizations.search(query="kultur", limit=3):
print(org.title, org.categories, org.target_groups)
# Filter to grant-giving organizations only
item = client.organizations.search(
form_of_impact=FormOfImpact.GRANT_GIVING_ORGANIZATION, limit=1
).first()
# Typed error handling on an invalid filter
try:
for org in client.organizations.search(query="stiftung", limit=2):
print(org.title, org.description[:80])
except InvalidInput as e:
print("invalid input:", e)
print("exercised: organizations.search")
Search foundations and organizations in the Spheriq Swiss nonprofit database. Returns paginated results with name, description, categories (topics), target groups, and organizational metadata. Results are auto-iterated; the SDK walks pages automatically. An empty query returns all entries. Each item carries resolved human-readable category labels derived from the NKS classification system used in Swiss philanthropy.
| Param | Type | Description |
|---|---|---|
| page | integer | Zero-based page index for pagination. |
| query | string | Free-text search query matching organization/project names and descriptions. |
| hits_per_page | integer | Number of results per page (1-1000). |
| form_of_impact | string | Filter by organization type. Omitted returns all types. |
{
"type": "object",
"fields": {
"page": "current page index (zero-based)",
"items": "array of organization/foundation records with id, title, description, categories, target_groups",
"total_hits": "total number of matching records",
"total_pages": "total pages available",
"hits_per_page": "results per page"
},
"sample": {
"data": {
"page": 0,
"items": [
{
"id": 10650,
"slug": "stiftung-wisli",
"tags": [
"stiftung",
"Arbeitsintegration"
],
"type": "organization",
"title": "Stiftung Wisli",
"categories": [
"Social in General",
"Social",
"Assisted Living (Retirement Home, Impairment)",
"Health in General",
"Health"
],
"description": "",
"target_groups": [
"Switzerland",
"Elderly People",
"Men",
"Refugees and Migrants"
],
"form_of_impact": "non_profit_organization",
"organization_name": "",
"organization_slug": ""
}
],
"total_hits": 9646,
"total_pages": 1930,
"hits_per_page": 5
},
"status": "success"
}
}About the Spheriq API
The Spheriq API on Parse exposes 1 endpoint for the publicly available data on app.spheriq.ch. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.