| page | No | 1-based, defaults to 1. | |
| seed | No | Only with sort='random': pass back the seed from the previous response so page 2 fits page 1. | |
| sort | No | Defaults to 'relevance'. Setting it also switches a bibleRef search back to the search API's order, instead of ordering by closeness to the passage. 'seriesOrder' sorts items by their position within a series and works best together with the 'series' filter. | |
| uids | No | Restrict the search to these content uids, e.g. ['lKE0QMlG7Y']. Narrows an existing result set — combine with other filters to ask whether these items match. It returns the items themselves, not the position of a passage inside them: hits carry the item's general teaser, no excerpt and no cursor. To locate a passage in the text, read the item with crossload_read_content. | |
| media | No | Media types the content must be available in, e.g. ['audio']. For images or presentations use 'category' instead. | |
| query | No | Free-text query, e.g. 'grace alone' or 'forgiveness in marriage'. A bible reference in the query text triggers a server-side boost on matching content — use the 'bibleRef' parameter for deliberate passage filtering instead. | |
| topic | No | Topic name, exactly as listed by crossload_browse, e.g. 'Vergebung'. Guessing the spelling yields no results. | |
| author | No | Author name, exactly as listed by crossload_browse, e.g. 'Roger Liebi'. | |
| series | No | Series name, exactly as listed by crossload_browse. | |
| yearTo | No | | |
| bibleRef | No | A German bible reference, e.g. 'Epheser 2', 'Joh 3,16-18' or 'Röm 8,28'. Filtering covers ranges in both directions: a lecture on Job 1-42 is found under 'Hiob 15', and 'Joh 3,16-18' excludes a sermon that stops at verse 15. A single verse is filtered as that one verse, so give a range if you mean the passage that follows. Items that only cite the passage in passing are left out unless 'includeSecondary' is set; their number is stated in the message, so totalHits for a passage search is counted here, not by the search API. Every hit carries 'matchedVia', saying whether the passage is its primary one or a secondary reference. Without 'query' and without 'sort', hits are ordered by how closely they match the passage: items covering the requested verses come first, then the ones with the tightest chapter range. Adding 'query' or 'sort' hands the order back to the search API. | |
| category | No | Exactly one category. The catalogue holds ~11.400 sermons, ~800 books and ~450 audio items. | |
| pageSize | No | Defaults to 10. With 'withExcerpts' the limit is 15, because every hit then carries an excerpt. | |
| yearFrom | No | | |
| durationMax | No | Maximum length in minutes, e.g. 30. | |
| durationMin | No | Minimum length in minutes. | |
| withExcerpts | No | Set this when you need to show WHERE in a text something is said, not just which texts say it: every hit then carries 'evidence', an excerpt of about 350 characters around the match, so you do not have to fetch the full transcript to quote it. Three conditions: it needs 'query', it cannot be combined with 'bibleRef', and 'pageSize' is then at most 15. The trade-off is that matching becomes literal: without it a query also finds texts that put the same thing in other words, with it only texts that contain the words themselves. No result therefore means the words do not appear, not that the topic is absent. An absent 'evidence' likewise does not prove the words are missing from the text. | |
| includeSecondary | No | Only with 'bibleRef' naming a chapter. Defaults to false, which lists only items whose primary passage matches. Set it to also list items that merely cite the passage, appended after the primary ones; each carries matchedVia='secondaryPassage' and matchedPassage naming the reference. A sermon on Psalm 139 citing John 3,16 is not a mismatch: it expounds the verse without filing it as its main passage. | |
