🟡 Filtern > Suche & Volltext

Worum geht’s hier?

Mit der Volltextsuche kannst du Inhalte in einem Endpoint schnell nach einem Suchbegriff filtern.

Das passiert über den Parameter:

filter[q] (bei POST im Body als filter.q)

➡️ Wichtig: Volltextsuche ist „ein erster Filter“ – du kannst sie mit anderen Filtern kombinieren (z. B. Klassifizierungen, Geo, Zeitraum, …).

GET: Volltextsuche über Query-Parameter

curl -s \
  -H "Authorization: Bearer {TOKEN}" \
  "{BASE_URL}/api/v4/endpoints/{ENDPOINT}?filter[q]=museum"

POST: Volltextsuche (übersichtlicher bei vielen Filtern)

curl -s \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -X POST \
  "{BASE_URL}/api/v4/endpoints/{ENDPOINT}" \
  -d '{
    "filter": {
      "q": "museum"
    }
  }'

Suche + Paging kombinieren

GET

curl -s \
  -H "Authorization: Bearer {TOKEN}" \
  "{BASE_URL}/api/v4/endpoints/{ENDPOINT}?filter[q]=museum&page[size]=25&page[number]=1"

POST

curl -s \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -X POST \
  "{BASE_URL}/api/v4/endpoints/{ENDPOINT}" \
  -d '{
    "filter": { "q": "museum" },
    "page": { "size": 25, "number": 1 }
  }'

URL-Encoding: Leerzeichen & Umlaute

Wenn du GET verwendest, musst du Sonderzeichen in der URL encoden:

Leerzeichen → %20
ä → %C3%A4 (UTF-8)
& → %26

Beispiel:

curl -s \
  -H "Authorization: Bearer {TOKEN}" \
  "{BASE_URL}/api/v4/endpoints/{ENDPOINT}?filter[q]=Wien%20Museum"

Bei POST ist das entspannter: du schreibst den Suchstring normal in JSON.

Suche mit anderen Filtern kombinieren (Beispiel)

Hier nur als Muster – die konkreten Filter zeigen wir in den jeweiligen Seiten:

curl -s \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -X POST \
  "{BASE_URL}/api/v4/endpoints/{ENDPOINT}" \
  -d '{
    "filter": {
      "q": "museum"
    },
    "page": {
      "size": 25,
      "number": 1
    }
  }'

Typische Fehlerbilder

200 OK, aber 0 Ergebnisse

Das heißt meist:

Im Endpoint gibt es keine passenden Inhalte
Der Begriff ist zu spezifisch
Ein zusätzlicher Filter schließt alles aus (UND-Logik)

400 Bad Request

Meist ist ein Parameter/Filter falsch aufgebaut oder (bei GET) die URL ist kaputt encodiert.

Platzhalter

Wir verwenden in Beispielen:

{BASE_URL}
{ENDPOINT}
{TOKEN}

Nächste Schritte

Filtern: Klassifizierungen
Filtern: Attribute
Sortierung