Free text search
Using either the
name and the
q URL parameters, you can search for text across multiple pre-defined fields:
The main difference between the two is that
q allows you to search through other fields than the pre-defined free text search fields.
For example, the following queries will NOT return the same results:
In this example, the
name parameter will look for documents that have the string
labels:Paspartoe in them, while the
q parameter will look for documents that actually have the label
See advanced queries for more info on the
The following fields will be searched when using the
q parameter with free text:
- IDs only return results if the complete ID is given in the free text input.
- Searching for a part of a word is not supported at the time of writing. For example, searching for
Theaterwill not return an organizer with the title
- Wildcards are supported. For example, searching for
Theater*will return results with
By default the
AND operator is used in between multiple given words.
So the query
grote post oostende actually becomes
grote AND post AND oostende.
It is possible to define the operator you want to use in the query itself. You could, for example, search for:
GET https://search.uitdatabank.be/offers/?q=(grote OR post) AND oostende
Note: if you want to specify the fields you want to search on, or search through fields that are not included by default, you should use the
By default the free text search looks for one or more matches with any of the given terms, regardless of their order and/or position in the document’s text.
For example, both a document with the title
Lekker vegetarisch and a different document with the title
Vegetarisch eten is niet lekker would be returned as results when searching for
To limit the results to exact matches, encapsulate the given search terms with double quotes:
GET https://search.uitdatabank.be/organizers/?name="lekker vegetarisch"
This will only return results that have
lekker vegetarisch in exactly that order in their text.
Encapsulated terms can still be combined with other terms, for example:
GET https://search.uitdatabank.be/organizers/?name="lekker vegetarisch" eten bereiden koken
By default the free text search looks for matching terms in both the original documents and their translations.
To limit your free text queries to one or more specific languages, you can use the
textLanguages URL parameter.
GET https://search.uitdatabank.be/organizers/?name="the editors"&textLanguages=nl
You can search through multiple languages by repeating the same parameter with a different value:
GET https://search.uitdatabank.be/organizers/?name="the editors"&textLanguages=nl&textLanguages=fr
Note that the
textLanguages parameter does not filter documents by their available languages. For example, when searching in both
fr, you can get results that only have either one language but still have a matching term in that specific language.
To actually filter documents by their available languages, see Languages.
Lees verder: Address