Polias Search API
Suchergebnisse aus einem eigenen europäischen Suchindex, für KI-Anwendungen, Assistenten, Suchdienste und Recherche-Werkzeuge. Ein Aufruf, eine Antwort in JSON, Server in der EU.
Angebot und Preise 1 € je 1.000 Anfragen, Websuche und KI-Suche aus einem Guthaben, 1.000 im Monat kostenlos.
Was Sie bekommen
- Eigener Index statt Weiterverkauf. Die Ergebnisse kommen aus unserem eigenen Suchindex mit über 115 Millionen Seiten aus Deutschland, Österreich und der Schweiz und den Nachrichten der letzten 30 Tage, nicht von Google, Bing oder einem anderen Anbieter.
- Je Treffer: Titel, Adresse, ein kurzer Ausschnitt (höchstens 160 Zeichen) und der Website-Name, bei Nachrichtenartikeln zusätzlich das Erscheinungsdatum. Auf Wunsch auch die Unterseiten, auf die ein Treffer verweist.
- Schnell: typischerweise deutlich unter einer Sekunde je Abruf.
- Sprachen: Deutsch, mit Vorrang für Deutschland, Österreich oder die Schweiz,
wenn Sie das Land mitgeben, und Englisch (
lang=en: Schwerpunkt Technik, siehe unten). Weitere europäische Sprachen sind im Aufbau. - Speichern erlaubt: Die Ergebnisse dürfen Sie bis zu 30 Tage speichern, ohne Aufpreis (Einzelheiten in den Bedingungen).
Was Sie nicht bekommen
Keine Bilder und keine Volltexte von Seiten, deren Lizenz das nicht erlaubt. Die Schnittstelle zeigt, wo etwas
steht; der Inhalt gehört den Betreibern der Websites. Wer die Seiten lesen will, ruft sie bei der Quelle auf.
Die KI-Suche (/v1/ki, gleicher Schlüssel, gleiches Guthaben) liefert zu jedem
Treffer zusätzlich Lizenzangaben und, wo die Lizenz es erlaubt, einen längeren Auszug mit Quellen- und Lizenzangaben.
Wo Polias schon läuft
Polias ist in der Metasuchmaschine MetaGer als Suchquelle zuschaltbar.
Datenschutz
Wir zählen nur, wie viele Suchen ein Schlüssel je Tag und Monat stellt, nicht, wonach gesucht wurde. Suchanfragen werden nicht gespeichert und nicht ausgewertet, außer Sie melden uns selbst eine Suche (siehe Anleitung); Meldungen löschen wir nach spätestens 30 Tagen. Alle Server stehen in der EU.
Preise
1 € je 1.000 Suchen, im Voraus als Paket; ab dem Paket zu 100 € gibt es 10 % mehr Suchen (100 € = 110.000, 250 € = 275.000). Für größere Mengen machen wir Ihnen gern ein Angebot. Ein Abruf mit bis zu 10 Treffern zählt als eine Suche; Abrufe von Verbrauch und Zustand sind frei. Die ersten 1.000 Suchen jedes Monats sind kostenlos.
Zugang
Die API ist für Unternehmen gedacht, auch für selbständige Entwickler. Das kostenlose Kontingent gibt es für Unternehmen in allen Ländern; Pakete kaufen können Firmen mit Sitz in Deutschland, in den anderen Ländern der EU (mit gültiger Umsatzsteuer-ID, geprüft über VIES; Rechnung ohne deutsche Umsatzsteuer, Reverse Charge) und in den USA (Rechnung ohne Umsatzsteuer). Für Firmen aus Russland, Belarus, Iran, Nordkorea, Syrien und Kuba bieten wir die Schnittstelle nicht an. Der Preis gilt in Euro. Sie legen Ihr Firmenkonto selbst an und bekommen den Schlüssel sofort, ohne Wartezeit und ohne Gespräch:
- Konto anlegen und E-Mail-Adresse bestätigen.
- Einen Weg zum kostenlosen Kontingent wählen. Jeder bringt 1.000 Suchen je Monat kostenlos,
das Kontingent beginnt am Monatsersten neu:
- Umsatzsteuer-Identifikationsnummer (automatische Prüfung bei der EU),
- feste IP-Adresse(n) Ihrer Server: Der Schlüssel gilt dann nur von dort,
- bestätigte E-Mail-Adresse: höchstens 100 Suchen am Tag. Das ist der Weg, wenn Sie Polias über Claude.ai, ChatGPT, n8n Cloud oder eine andere KI-Plattform in der Cloud nutzen. Deren Anfragen kommen von wechselnden Adressen des Anbieters.
- Schlüssel kopieren und loslegen. Brauchen Sie mehr, kaufen Sie Pakete im Portal per Karte, die Rechnung kommt automatisch. Gekaufte Suchen kommen zum Kontingent dazu, ein Tageslimit gibt es dann nicht.
Im Portal sehen Sie Ihr Guthaben, Ihre Suchen je Tag und Ihre Rechnungen; einen verlorenen Schlüssel ersetzen Sie dort selbst. Es gelten die Bedingungen der Such-Schnittstelle. Fragen: hallo@polias.eu.
Anleitung für Entwickler
Code, Beispiele und Baukasten: fertige Beispiel-Projekte als ZIP (Rechts-Assistent, Doku-Suche für Coding-Agents, Nachrichten-Feed, Bürger-Chatbot, Metasuche), ein Baukasten zum Anklicken und Bausteine in vielen Sprachen: api.polias.eu/examples.
Polias Legal (Gerichtsentscheidungen, Gesetze und EU-Recht mit Filtern nach Gericht, Rechtsgebiet, Datum und zitierter Norm): api.polias.eu/legal.
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.
Bereiche wählen: Web, Nachrichten, Recht, amtlich (result_filter)
Mit result_filter wählen Sie, was eine Suche liefert, mehrere Bereiche mit Komma getrennt
(deutscher Name gleichwertig: bereich). Jeder Bereich kommt als eigener Block mit
results. Höchstens 10 Treffer je Anfrage, egal wie viele Bereiche Sie wählen, und
jede Anfrage zählt als eine Suche.
web: Websuchenews: Nachrichtenartikel der letzten 30 Tage (lang=deoderen), jeder mitpage_age. Bei Presseartikeln zeigen wir nur Titel, Link und den kurzen Anreißer des Verlags (höchstens 160 Zeichen), bei manchen Verlagen nur Titel und Link.recht: Polias Recht, Gerichtsentscheidungen und EU-Recht aus Deutschland, Österreich, der Schweiz und der EU, dazu Spanien und die Niederlande. Mitlandwählen Sie Länder (de, at, ch, eu, es, nl, mehrere mit Komma), mitartdie Art (z. B.entscheid). Je nach Treffer gibt esgericht,aktenzeichen,datum,leitsatz,ecli,celex,normenund immerlizenzundhinweis(Quellenangabe, bitte mit anzeigen). Alle Filter für Rechtstreffer (Gericht, Instanz, Datum, zitierte Norm …) beschreibt Polias Legal.amtlich: nur Treffer von amtlichen Websites in Deutschland, Österreich, der Schweiz und der EU (Behörden, Gemeinden, Landkreise, Ministerien, Gerichte, Kammern), derzeit nur mitlang=de, im Blockamtlich(Felder wie bei der Websuche). Gibt es zu einer Frage keine passenden amtlichen Seiten, kommen weniger oder keine. Mitort=bevorzugen Sie die Behörde vor Ort. Mitnewsundrechtkombinierbar, nicht mitweb, weilamtlichschon die Websuche auf amtlichen Quellen ist.
Ohne result_filter bleibt alles wie bisher: Websuche als eine Liste results, in die bei
Aktenzeichen und Normzitaten passende Rechtstreffer eingereiht sind. Ist web dabei und Sie geben
keinen Anteil an, kommen Nachrichten und Rechtstreffer nur, wenn sie zur Suche passen. Mit
news_count und recht_count (je 0–10) legen Sie den Anteil selbst fest, die Websuche
füllt auf. Ohne web teilen sich die gewählten Bereiche die Plätze. Ist ein Bereich gerade nicht
erreichbar, kommen die anderen trotzdem, und sein Block trägt "error". Liefert kein gewählter
Bereich, kommt 502 und es wird nichts abgezogen. Unbekannte Werte ergeben 400.
curl -H "Authorization: Bearer pol_IhrSchluessel" "https://api.polias.eu/v1/search?q=bundestag&result_filter=news&count=5" curl -H "Authorization: Bearer pol_IhrSchluessel" "https://api.polias.eu/v1/search?q=VIII+ZR+15/23&result_filter=web,recht" curl -H "Authorization: Bearer pol_IhrSchluessel" "https://api.polias.eu/v1/search?q=k%C3%BCndigung+eigenbedarf&result_filter=web,recht&recht_count=3&land=de" curl -H "Authorization: Bearer pol_IhrSchluessel" "https://api.polias.eu/v1/search?q=hundesteuer&ort=K%C3%B6ln&result_filter=amtlich"
{
"query": "VIII ZR 15/23", "lang": "de", "result_filter": ["web", "recht"],
"web": { "results": [ { "position": 1, "title": "…", "url": "https://…", "snippet": "…", "hostname": "…" } ], "total": 1234 },
"recht": { "results": [ { "position": 1, "title": "BGH, Urteil vom … - VIII ZR 15/23", "url": "https://…",
"snippet": "…", "hostname": "…", "land": "de", "art": "entscheid", "gericht": "BGH",
"aktenzeichen": "VIII ZR 15/23", "datum": "…", "entscheidungsart": "Urteil",
"leitsatz": "…", "normen": ["§ 573 Abs 2 Nr 2 BGB"], "lizenz": "…", "hinweis": "…" } ] },
"corrected": "", "suggestion": "", "took_ms": 140,
"usage": { "today": 12, "month": 340, "guthaben": 98760 }
}
Fertiger Code für alle Bereiche: api.polias.eu/examples.
Fehler: 400 q fehlt oder falsche Angabe · 401 Schlüssel
fehlt oder unbekannt · 403 Schlüssel ist an feste IP-Adressen gebunden, die Anfrage kommt von einer
anderen · 402 kostenloses Kontingent und Guthaben aufgebraucht (Pakete im Portal; sonst im nächsten Monat wieder kostenlos) ·
429 Grenze je Minute oder Tageslimit erreicht (Kopf Retry-After = Sekunden bis zum
nächsten Versuch) · 502 Index
antwortet gerade nicht, bitte kurz später erneut · 503 nur mit quelle=amtlich: diese
Auswahl ist kurz nicht verfügbar, die normale Suche geht weiter. Fehlversuche kosten nichts.
Guthaben und Grenzen: Jede beantwortete Suche über das kostenlose Kontingent hinaus zieht eine vom Guthaben ab; Guthaben verfällt nicht. Höchstens 600 Suchen je Minute, mehr auf Anfrage. Wir zählen nur die Anzahl der Suchen je Schlüssel, Tag und Monat, nicht, wonach gesucht wurde.
Suchen, die nicht gut laufen: Schicken Sie uns gern die Suchwörter, am besten mit der Website,
die Sie erwartet hätten, oder einfach unsere Antwort an
hallo@polias.eu. Bitte nur Suchwörter ohne Bezug zu einzelnen
Personen. Wir nutzen sie nur, um die Suche zu verbessern, und löschen sie, wenn der Fall erledigt ist.
Oder senden Sie die Suche direkt mit POST /v1/melden (kostet kein Guthaben). Auch hier bitte nur
Suchwörter ohne Bezug zu einzelnen Personen.
curl -X POST -H "Authorization: Bearer pol_IhrSchluessel" -H "Content-Type: application/json" -d '{"q": "anwohnerparken dresden", "erwartet": "dresden.de", "text": "Amtliche Seite fehlt"}' "https://api.polias.eu/v1/melden"
Nur q ist Pflicht. Dazu können Sie lang, erwartet (die Website, die Sie
erwartet hätten), urls (unsere Treffer, die Sie bekommen haben) und text (höchstens
300 Zeichen) mitschicken. Antwort: 204.
Als Werkzeug für KI-Assistenten (MCP)
Unterstützt Ihre KI-Plattform das Model Context Protocol (MCP), binden Sie die Polias-Suche ohne eigene
Programmierung als Werkzeug ein: Adresse https://api.polias.eu/mcp (Transport „Streamable HTTP“),
Kopf Authorization: Bearer <Ihr Schlüssel>. Das Werkzeug heißt suche und nimmt
frage (Pflicht, höchstens 200 Zeichen), anzahl (1–10), start (0–90),
sprache (de oder en, wie lang), land (de, at, ch), ort (Gemeinde, höchstens 80
Zeichen) und quelle (amtlich), mit derselben Bedeutung wie oben. Es liefert dieselben Treffer wie
/v1/search, jede Suche über das kostenlose Kontingent hinaus zieht eine vom Guthaben ab, Grenzen und Fehler sind dieselben. Das Werkzeug
reicht die Anfrage nur weiter und speichert nichts. Ohne sprache sucht es auf Deutsch;
ort und quelle gibt es nur für Deutsch.
{
"mcpServers": {
"polias": {
"url": "https://api.polias.eu/mcp",
"headers": { "Authorization": "Bearer pol_IhrSchluessel" }
}
}
}
Die genaue Form der Einstellung hängt von Ihrer Plattform ab; nötig sind immer nur Adresse und Kopf.
In freien KI-Programmen einrichten
Ersetzen Sie jeweils pol_IhrSchluessel durch Ihren Schlüssel.
- Open WebUI als Websuche: Adminbereich → Einstellungen → Websuche, Suchmaschine
external, Adressehttps://polias.eu/openwebui, API-Schlüssel: Ihr Schlüssel. Angaben hinter der Adresse gelten dann für alle Suchen, z. B./openwebui?quelle=amtlich,/openwebui?land=atoder/openwebui?sprache=en(Englisch). Dieser Anschluss reicht die Suche wie das MCP-Werkzeug nur weiter und speichert nichts; Angaben zur Person, die Open WebUI mitschicken kann, werten wir nicht aus. - Open WebUI als Werkzeug (ab Version 0.6.31): Adminbereich → Einstellungen → Integrationen,
„External Tool Servers“ → „Add Connection“, Typ „MCP (Streamable HTTP)“, Adresse
https://api.polias.eu/mcp, Auth „Bearer“ mit Ihrem Schlüssel. - LibreChat (
librechat.yaml, Schlüssel in der UmgebungsvariablePOLIAS_KEY):mcpServers: polias: type: streamable-http url: https://api.polias.eu/mcp headers: Authorization: 'Bearer ${POLIAS_KEY}' - AnythingLLM (
anythingllm_mcp_servers.jsonim Ordnerplugins, danach in der MCP-Verwaltung neu laden):{ "mcpServers": { "polias": { "type": "streamable", "url": "https://api.polias.eu/mcp", "headers": { "Authorization": "Bearer pol_IhrSchluessel" } } } } - n8n: am KI-Agenten den Baustein „MCP Client Tool“ anhängen, Adresse
https://api.polias.eu/mcp, Übertragung „HTTP Streamable“, Anmeldung „Bearer“ mit Ihrem Schlüssel. - Dify: Werkzeuge → MCP → MCP-Server hinzufügen (HTTP), Adresse
https://api.polias.eu/mcp, KopfAuthorizationmitBearer pol_IhrSchluessel.
Search results from our own European web index, for AI applications, assistants, search services and research tools. One request, one JSON response, servers in the EU.
Offer and prices €1 per 1,000 requests, web search and AI search from one balance, 1,000 a month free.
What you get
- Our own index, not resold. Results come from our own search index with over 115 million pages from Germany, Austria and Switzerland plus news from the last 30 days, not from Google, Bing or any other provider.
- Per result: title, URL, a short snippet (max. 160 characters) and the site name; for news articles also the publication date. On request also the sub-pages a result links to.
- Fast: typically well under one second per request.
- Languages: German, with priority for Germany, Austria or Switzerland if you pass the country,
and English (
lang=en: focus on technical topics, see below). More European languages are being added. - Storage allowed: you may store results for up to 30 days at no extra cost (details in the terms).
What you don't get
No images, and no full texts of pages whose licence does not allow it. The API shows where something is; the
content belongs to the website owners. To read a page, open it at the source. AI search
(/v1/ki, same key and credit) adds licence information to each result and, where the licence
allows, a longer excerpt with source and licence details.
Where Polias is already used
Polias can be enabled as a search source in the meta search engine MetaGer.
Privacy
We only count how many searches a key makes per day and month, not what was searched. Queries are neither stored nor analysed, unless you report a search to us yourself (see the guide); reports are deleted after 30 days at the latest. All servers are in the EU.
Prices
€1 per 1,000 searches, prepaid in packages; from the €100 package on you get 10 % more searches (€100 = 110,000, €250 = 275,000). For larger volumes we are happy to make you an offer. A request with up to 10 results counts as one search; usage and status requests are free. The first 1,000 searches each month are free. Prices are in euros.
Access
The API is for companies, including self-employed developers. The free allowance is open to companies in every country; packages can be bought by companies based in Germany, in the other EU countries (with a valid VAT ID, checked automatically against the EU's VIES; invoiced without German VAT under the reverse charge procedure) and in the USA (invoiced without VAT). We cannot offer the API to companies from Russia, Belarus, Iran, North Korea, Syria or Cuba. Prices are in euros; Stripe converts them to your card's currency. You create your company account yourself and get your key right away, without waiting and without a sales call:
- Create an account and confirm your email address.
- Choose a route to the free allowance. Each one gives 1,000 free searches a month; the allowance
restarts on the first of each month:
- VAT identification number (checked automatically with the EU),
- fixed IP address(es) of your servers: the key then only works from there,
- confirmed email address: at most 100 searches a day. This is the route if you use Polias through Claude.ai, ChatGPT, n8n Cloud or another cloud AI platform, whose requests come from changing addresses of the provider.
- Copy your key and start. If you need more, buy packages by card in the portal; invoices are issued automatically. Purchased searches are added to the allowance, and there is no daily limit any more.
In the portal you see your credit, your searches per day and your invoices; you can replace a lost key there yourself. The terms of the search API apply (English translation; the German version is legally binding). Questions: hallo@polias.eu.
Developer guide
Code, examples and project builder: ready-to-run example projects as ZIP (legal research assistant, docs search for coding agents, news feed, citizen service chatbot, meta search), a project builder and snippets in many languages: api.polias.eu/examples.
Polias Legal (court decisions, legislation and EU law, filtered by court, area of law, date and cited provision): api.polias.eu/legal.
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.
Choosing areas: web, news, legal, official (result_filter)
With result_filter you choose what a search returns, several areas separated by commas (German alias:
bereich). Each area comes as its own block with results. At most 10 results per
request, however many areas you choose, and every request counts as one search.
web: web searchnews: news articles of the last 30 days (lang=deoren), each withpage_age. For press articles we only show title, link and the publisher's short teaser (max. 160 characters), for some publishers title and link only.recht: Polias Recht, court decisions and EU law from Germany, Austria, Switzerland and the EU, plus Spain and the Netherlands. Choose countries withland(de, at, ch, eu, es, nl, several separated by commas) and the type withart(e.g.entscheid). Depending on the result there aregericht(court),aktenzeichen(case number),datum,leitsatz(headnote),ecli,celex,normenand alwayslizenzandhinweis(source notice, please show it with the result). All filters for legal results (court, instance, date, cited provision …) are described at Polias Legal.amtlich: only results from official websites in Germany, Austria, Switzerland and the EU (authorities, municipalities, districts, ministries, courts, chambers); currentlylang=deonly, in the blockamtlich(same fields as web results). If no suitable official page exists for a query you get fewer or none. Addort=to prefer the local authority. It combines withnewsandrecht, not withweb, becauseamtlichalready is web search restricted to official sources.
Without result_filter nothing changes: web search as one list results, with matching
legal results for case numbers and citations. With web and no share given, news and legal results
only come when they fit the query. news_count and recht_count (0–10 each) fix a share,
and web fills the rest. Without web the chosen areas share the places. If one area is briefly
unavailable, the others still come and its block carries "error". If no chosen area answers, you get
502 and nothing is charged. Unknown values give 400.
curl -H "Authorization: Bearer pol_yourkey" "https://api.polias.eu/v1/search?q=bundestag&result_filter=news&count=5" curl -H "Authorization: Bearer pol_yourkey" "https://api.polias.eu/v1/search?q=docker+security&lang=en&result_filter=web,news&news_count=3" curl -H "Authorization: Bearer pol_yourkey" "https://api.polias.eu/v1/search?q=VIII+ZR+15/23&result_filter=web,recht" curl -H "Authorization: Bearer pol_yourkey" "https://api.polias.eu/v1/search?q=hundesteuer&ort=K%C3%B6ln&result_filter=amtlich"
The answer has one block per area, e.g. {"web": {"results": […]}, "recht": {"results": […]}}; the
fields of each result are as above. Ready-made code for all areas: api.polias.eu/examples.
Errors: 400 q missing or invalid parameter · 401 key missing
or unknown · 403 the key is bound to fixed IP addresses and the request comes from another one ·
402 free allowance and credit used up (packages in the portal; otherwise free again next month) ·
429 per-minute or daily limit reached (header Retry-After = seconds until the next try) ·
502 the index is not responding right now, please retry shortly · 503 only with
quelle=amtlich: this filter is briefly unavailable, normal search keeps working. Failed requests are free.
Credit and limits: every answered search beyond the free allowance costs one search from your credit; credit does not expire. At most 600 searches per minute, more on request. We only count the number of searches per key, day and month, never what was searched.
Searches that don't work well: feel free to send us the search terms, ideally with the website you
expected, or simply our response, to hallo@polias.eu. Please only
send search terms that do not relate to individual people. We use them only to improve the search and delete them
once the case is resolved, after 30 days at the latest. Or send the search directly with POST /v1/melden (free of charge). Here
too, please only search terms that do not relate to individual people.
curl -X POST -H "Authorization: Bearer pol_yourkey" -H "Content-Type: application/json" -d '{"q": "anwohnerparken dresden", "erwartet": "dresden.de", "text": "Official page missing"}' "https://api.polias.eu/v1/melden"
Only q is required. You can also send lang, erwartet (the website you
expected), urls (our results you received) and text (max. 300 characters). Response:
204.
As a tool for AI assistants (MCP)
If your AI platform supports the Model Context Protocol (MCP), add Polias search as a tool without writing code:
URL https://api.polias.eu/mcp (transport "Streamable HTTP"), header
Authorization: Bearer <your key>. The tool is called suche and takes
frage (query, required, max. 200 characters), anzahl (1–10), start (0–90),
sprache (de or en, like lang), land (de,
at, ch), ort (municipality, max. 80 characters) and quelle
(amtlich), meaning the same as above. It returns the same results as /v1/search; every
search beyond the free allowance costs one search from your credit, limits and errors are the same. The tool only
forwards the request and stores nothing. Without sprache it searches in German; ort and
quelle are German only.
{
"mcpServers": {
"polias": {
"url": "https://api.polias.eu/mcp",
"headers": { "Authorization": "Bearer pol_yourkey" }
}
}
}
The exact form of the setting depends on your platform; all it ever needs is the URL and the header.
Setting it up in open AI tools
Replace pol_yourkey with your key in each case.
- Open WebUI as web search: Admin Panel → Settings → Web Search, engine
external, URLhttps://polias.eu/openwebui, API key: your key. Parameters added to the URL apply to all searches, e.g./openwebui?quelle=amtlich,/openwebui?land=ator/openwebui?sprache=en(English). Like the MCP tool, this connector only forwards the search and stores nothing; personal details Open WebUI may send along are not used. - Open WebUI as a tool (version 0.6.31 or later): Admin Panel → Settings → Integrations,
"External Tool Servers" → "Add Connection", type "MCP (Streamable HTTP)", URL
https://api.polias.eu/mcp, auth "Bearer" with your key. - LibreChat (
librechat.yaml, key in the environment variablePOLIAS_KEY):mcpServers: polias: type: streamable-http url: https://api.polias.eu/mcp headers: Authorization: 'Bearer ${POLIAS_KEY}' - AnythingLLM (
anythingllm_mcp_servers.jsonin thepluginsfolder, then reload in the MCP management):{ "mcpServers": { "polias": { "type": "streamable", "url": "https://api.polias.eu/mcp", "headers": { "Authorization": "Bearer pol_yourkey" } } } } - n8n: attach the "MCP Client Tool" node to the AI agent, URL
https://api.polias.eu/mcp, transport "HTTP Streamable", authentication "Bearer" with your key. - Dify: Tools → MCP → add MCP server (HTTP), URL
https://api.polias.eu/mcp, headerAuthorizationwithBearer pol_yourkey.