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 Zeichencount: Treffer je Abruf, 1–10 (Standard 10)offset: ab welchem Treffer, 0–90 (Seite 2 = 10)lang: Sprache des Index,de(Standard) oderen.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.ortundquelle=amtlichnur für Deutsch.land: Land bevorzugen, z. B.de,at,chort: 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 characterscount: results per request, 1–10 (default 10)offset: start at result, 0–90 (page 2 = 10)lang: index language,de(default) oren.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).ortandquelle=amtlichare German only.land: prefer a country, e.g.de,at,chort: 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.