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: 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.
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.