Exhaustive keyword scan (experimental)
EXPERIMENTAL — this endpoint may change or be removed without notice. Exhaustive keyword scan for data analysis and export. Evaluates the boolean query as a strict full-text filter and returns every matching chunk, flat (ungrouped) and paginated. Unlike /search there is no relevance ranking: all hits satisfy the query equally and arrive in a stable order. Paginate by passing meta.pagination.nextCursor as cursor until it is null.
API key as Bearer token
In: header
Query Parameters
Boolean keyword query evaluated as a strict full-text filter — a chunk either matches or it does not; there is no ranking. Supports AND (default, also implicit between adjacent terms), OR (alternation), NOT or leading - (exclusion), ( … ) for grouping, "…" for exact phrase match. Example: windkraft AND ("erneuerbare energien" OR solar) -atomkraft. Operators must be uppercase; lowercase words are treated as regular terms. Without q the scan lists every chunk that matches the filters.
1 <= length <= 1000chunkType filter as repeated query params or comma-separated list. Defaults to all types. Allowed values: agendaItemTitle, agendaItemDescription, document, proposalTitle, proposalDescription
Entity IDs (Regionalschlüssel) as repeated query params or comma-separated list. Use * suffix for prefix matching: 01* matches all entities in Schleswig-Holstein, 03101 matches LK Braunschweig exactly. Unallowed entities are silently stripped; the search runs only against permitted entities. Mutually exclusive with bbox.
Bounding box as 'west,south,east,north' (lon/lat). Resolves to entities whose geographic bounds intersect this box. Only entities the caller is permitted to access are included. Mutually exclusive with entities.
Administrative levels as repeated query params or comma-separated list. Values: 10=Bundesland, pr=Planungsregion, 40=Landkreis, 50=Verbandsgemeinde, 60=Kommune
Filter from this date (inclusive, ISO 8601)
dateFilter up to this date (inclusive, ISO 8601)
dateOnly return results ingested since this datetime (inclusive, ISO 8601). Useful for polling new content since the last check.
date-timeOnly return results ingested before this datetime (exclusive, ISO 8601). Together with newSince it covers consecutive time windows without overlap.
date-timePage size (number of chunks per page, max 1000).
5001 <= value <= 1000Number of matching chunks to skip. Keep query and filters identical across pages of one scan. The scan runs against a live index: items ingested or removed mid-scan can shift the sequence, so a chunk near a page boundary may be skipped or repeated. Large offsets get progressively slower, prefer cursor for full exports.
00 <= value <= 9007199254740991Opaque cursor from meta.pagination.nextCursor of the previous page. Continues the scan right after that page at constant cost per page. Items ingested or removed mid-scan never cause skips or repeats of other items. Keep query and filters identical. Cannot be combined with offset.
length <= 100Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.poliscope.de/v2/search/scan"{
"data": [
{
"id": "string",
"chunkType": "agendaItemTitle",
"groupKey": "string",
"groupType": "meeting",
"text": "string",
"highlights": [
[
0,
0
]
],
"agendaItemId": "string",
"documentId": "string",
"proposalId": "string",
"pageFrom": 0,
"pageTo": 0,
"pageFromOffsetPct": 0,
"pageFromOffset": 0,
"pageToOffset": 0,
"poliscopeUrl": "string",
"fileUrl": "string",
"entityId": "string",
"entityLevel": "string",
"entityName": "string",
"parents": [
{
"id": "string",
"name": "string",
"level": "string"
}
],
"location": {
"lat": 0,
"lon": 0
},
"date": "string"
}
],
"meta": {
"pagination": {
"total": 0,
"limit": 0,
"offset": 0,
"nextCursor": "string"
}
}
}{
"error": "BAD_REQUEST",
"message": "string",
"feature": "string"
}{
"error": "BAD_REQUEST",
"message": "string",
"feature": "string"
}{
"error": "BAD_REQUEST",
"message": "string",
"feature": "string"
}{
"error": "BAD_REQUEST",
"message": "string",
"feature": "string"
}{
"error": "BAD_REQUEST",
"message": "string",
"feature": "string"
}