ContentsInhalt

Web searchWebsuche

Adresse: GET https://api.polias.eu/v1/search. Schlüssel im Kopf Authorization: Bearer <Ihr Schlüssel> (oder X-API-Key: <Ihr Schlüssel>). Halten Sie ihn geheim; einen verlorenen Schlüssel ersetzen Sie im Portal selbst, der alte gilt dann nicht mehr.

curl -H "Authorization: Bearer pol_IhrSchluessel" \
  "https://api.polias.eu/v1/search?q=wetter+berlin&land=de"

Angaben in der Adresse:

  • q: Suchanfrage, Pflicht, höchstens 200 Zeichen
  • count: Treffer je Abruf, 1–10 (Standard 10)
  • offset: ab welchem Treffer, 0–90 (Seite 2 = 10)
  • lang: Sprache des Index, de (Standard) oder en. lang=en: englische Suche mit Schwerpunkt Technik: Entwickler-Dokumentation, Programmierung, Software und IT, dazu die englische Wikipedia. Für allgemeine englischsprachige Suchen (Orte, Nachrichten, Einkaufen) ist sie noch nicht gedacht. ort und quelle=amtlich nur für Deutsch.
  • land: Land bevorzugen, z. B. de, at, ch
  • ort: Ort der Suche, eine Gemeinde in Deutschland, Österreich oder der Schweiz, z. B. Freiburg im Breisgau; wirkt, als stünde der Ort in der Suche (nennt die Suche schon einen Ort, gilt dieser)
  • quelle=amtlich: nur Treffer von amtlichen Websites nach einer festen Liste (Bund, Länder, Gemeinden, Gerichte und Behörden in Deutschland, Österreich und der Schweiz sowie die EU)
  • safe=0: Jugendschutz-Filter aus (Standard an)
  • links=1: je Treffer auch die Unterseiten, auf die er verweist

Antwort (JSON):

{
  "query": "wetter berlin",
  "lang": "de",
  "results": [
    { "position": 1, "title": "…", "url": "https://…",
      "snippet": "… (höchstens 160 Zeichen)", "hostname": "www.…",
      "page_age": "2026-10-20T09:12:05" }
  ],
  "total": 1234,
  "corrected": "", "suggestion": "",
  "took_ms": 180,
  "usage": { "today": 12, "month": 340, "guthaben": 98760 }
}

page_age steht nur bei Nachrichtenartikeln (Erscheinungszeit, deutsche Ortszeit). corrected ist gefüllt, wenn wir einen Tippfehler verbessert haben. Mit ort sagt das Feld ort in der Antwort, welcher Ort genommen wurde (leer: keiner, etwa weil unbekannt). ort und quelle kosten nichts extra und lassen sich kombinieren. GET /v1/usage (mit Schlüssel) zeigt Suchen heute und im Monat sowie das verbleibende Guthaben, GET /v1/health (ohne Schlüssel) den Zustand.

Endpoint: GET https://api.polias.eu/v1/search. Key in the header Authorization: Bearer <your key> (or X-API-Key: <your key>). Keep it secret; you can replace a lost key in the portal, the old one then stops working.

curl -H "Authorization: Bearer pol_yourkey" \
  "https://api.polias.eu/v1/search?q=wetter+berlin&land=de"

Parameters:

  • q: query, required, max. 200 characters
  • count: results per request, 1–10 (default 10)
  • offset: start at result, 0–90 (page 2 = 10)
  • lang: index language, de (default) or en. lang=en: English search focused on technical topics: developer documentation, programming, software and IT, plus English Wikipedia. It is not yet intended for general English-language queries (places, news, shopping). ort and quelle=amtlich are German only.
  • land: prefer a country, e.g. de, at, ch
  • ort: the town of the search, a municipality in Germany, Austria or Switzerland, e.g. Freiburg im Breisgau; works as if the town were in the query (a town already in the query takes precedence)
  • quelle=amtlich: only results from official websites on a fixed list (federal, state and local government, courts and authorities in Germany, Austria and Switzerland, and the EU)
  • safe=0: safe search off (on by default)
  • links=1: for each result also the sub-pages it links to

Response (JSON):

{
  "query": "wetter berlin",
  "lang": "de",
  "results": [
    { "position": 1, "title": "…", "url": "https://…",
      "snippet": "… (max. 160 characters)", "hostname": "www.…",
      "page_age": "2026-10-20T09:12:05" }
  ],
  "total": 1234,
  "corrected": "", "suggestion": "",
  "took_ms": 180,
  "usage": { "today": 12, "month": 340, "guthaben": 98760 }
}

page_age is only present for news articles (publication time, German local time). corrected is filled if we corrected a typo. With ort, the response field ort shows which town was used (empty: none, e.g. because it is unknown). ort and quelle cost nothing extra and can be combined. usage.guthaben is your remaining credit. GET /v1/usage (with key) shows searches today and this month plus the remaining credit, GET /v1/health (no key) the status.