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

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:

  1. Konto anlegen und E-Mail-Adresse bestätigen.
  2. 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.
    Die Wege dienen dem Schutz vor Missbrauch; je Konto gilt einer.
  3. 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.

Firmenkonto anlegen

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:

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.

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.

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

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:

  1. Create an account and confirm your email address.
  2. 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.
    The routes protect against abuse; one applies per account.
  3. 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.

Create a company account

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:

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.

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.

← Back to search← Zurück zur Suche