Free text search
Using either the
text and the
q URL parameters, you can search for text across multiple pre-defined fields:
GET https://search.uitdatabank.be/offers/?text=dit is een test
GET https://search.uitdatabank.be/offers/?q=dit is een test
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
text 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 either the
text parameter, or 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
Fietswill not return an event with the title
Fietsen langs de Dijle.
- Wildcards are supported. For example, searching for
Fiets*will return results with
By default the
AND operator is used in between multiple given words.
So the query
wandelen fietsen dijle actually becomes
wandelen AND fietsen AND dijle.
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/?text=(wandelen OR fietsen) AND dijle
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 an event with the title
Lekker vegetarisch and a different event 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/offers/?text="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/offers/?text="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/offers/?text="the editors"&textLanguages=nl
You can search through multiple languages by repeating the same parameter with a different value:
GET https://search.uitdatabank.be/offers/?text="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