ContentsInhalt

Areas: news, legal, officialBereiche: Nachrichten, Recht, amtlich

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: Websuche
  • news: Nachrichtenartikel der letzten 30 Tage (lang=de oder en), jeder mit page_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. Mit land wählen Sie Länder (de, at, ch, eu, es, nl, mehrere mit Komma), mit art die Art (z. B. entscheid). Je nach Treffer gibt es gericht, aktenzeichen, datum, leitsatz, ecli, celex, normen und immer lizenz und hinweis (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 mit lang=de, im Block amtlich (Felder wie bei der Websuche). Gibt es zu einer Frage keine passenden amtlichen Seiten, kommen weniger oder keine. Mit ort= bevorzugen Sie die Behörde vor Ort. Mit news und recht kombinierbar, nicht mit web, weil amtlich schon 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.

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 search
  • news: news articles of the last 30 days (lang=de or en), each with page_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 with land (de, at, ch, eu, es, nl, several separated by commas) and the type with art (e.g. entscheid). Depending on the result there are gericht (court), aktenzeichen (case number), datum, leitsatz (headnote), ecli, celex, normen and always lizenz and hinweis (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); currently lang=de only, in the block amtlich (same fields as web results). If no suitable official page exists for a query you get fewer or none. Add ort= to prefer the local authority. It combines with news and recht, not with web, because amtlich already 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.