Search the Platform for Bible verses, related topics, verse images, and query suggestions. Includes the unified endpoint that returns all kinds at once and the kind-specific paginated endpoints.
Get suggested or trending search queries.
Returns query objects (a search string and its source). Supply query with language_ranges[] for as-you-type suggestions, or trending=true with language_ranges[] for recently popular searches. When trending=true, query is ignored. The first language range supported by search is used.
query Parameters
language_ranges[]An ordered list of language ranges using bracket notation. Use repeated parameters like language_ranges[]=en&language_ranges[]=es to supply multiple ranges, and use the wildcard * to match all languages. A language range is much like a language tag but may contain wildcards. See RFC 4647 section 2 for the full definition: https://www.rfc-editor.org/rfc/rfc4647.html#section-2
Language ranges in this parameter may only be of the Basic Range format.
queryThe partial query for as-you-type suggestions. Omit for trending queries.
trendingReturn recently popular searches for the language instead of suggestions.
Get suggested or trending search queries. › Responses
Successful request
Search the Platform for Bible verses, topics and images.
Search for Bible verses, related topics and verse images by query, returning a single unified set of results across all content kinds. Verse results carry references and metadata only (e.g. JHN.3.16), never passage text; resolve verse text through the licensed-content endpoint.
This endpoint is unpaginated: it returns one combined page of top results per kind and exposes no page_size or page_token parameters. Use the kind-specific endpoints (search-verses, search-topics, search-images) when you need to page through the full result set for a single kind.
query Parameters
queryThe search query string used to find matching results.
bible_idThe Bible version identifier
language_ranges[]An ordered list of language ranges using bracket notation. Use repeated parameters like language_ranges[]=en&language_ranges[]=es to supply multiple ranges, and use the wildcard * to match all languages. A language range is much like a language tag but may contain wildcards. See RFC 4647 section 2 for the full definition: https://www.rfc-editor.org/rfc/rfc4647.html#section-2
Language ranges in this parameter may only be of the Basic Range format.
user_intentThe searcher's intent. Defaults to unknown, matching the Core Search service.
fields[]Result kinds to include: verses, topics and/or images. Use bracket notation to pass
multiple values, for example fields[]=verses&fields[]=images. Omit to return all kinds.
Query metadata is always included.
Search the Platform for Bible verses, topics and images. › Responses
Successful request
user_intentThe intent the Core Search service resolved for the query.
did_you_meanAlternative spellings the search service suggests for the query.
search_instead_forA corrected query the results were actually returned for, if any.
Search the Platform for topics related to a query.
Returns the set of topics (id, text, subtopics) related to a query, for pivoting to other verses in the same topic.
This endpoint is unpaginated: Core Search returns a fixed set of topics and exposes no page_size or page_token parameters. Query metadata (did_you_mean, search_instead_for) is always included.
query Parameters
queryThe search query string used to find matching results.
language_ranges[]An ordered list of language ranges using bracket notation. Use repeated parameters like language_ranges[]=en&language_ranges[]=es to supply multiple ranges, and use the wildcard * to match all languages. A language range is much like a language tag but may contain wildcards. See RFC 4647 section 2 for the full definition: https://www.rfc-editor.org/rfc/rfc4647.html#section-2
Language ranges in this parameter may only be of the Basic Range format.
Search the Platform for topics related to a query. › Responses
Successful request
did_you_meanAlternative spellings the search service suggests for the query.
search_instead_forA corrected query the topics were actually returned for, if any.
total_sizeTotal number of topics returned in this response. Because the endpoint is unpaginated, this is the full count returned, not a running total across pages.
Search the Platform for Bible verses.
Search for Bible verses by query, returning a paginated list of verse references. Verse results carry references and metadata only (e.g. JHN.3.16), never passage text; resolve verse text through the licensed-content endpoint. The bible_id determines the language searched, so this endpoint takes no language parameter. Use page_size and page_token to page through the full result set.
query Parameters
queryThe search query string used to find matching results.
bible_idThe Bible version identifier
user_intentThe searcher's intent. Defaults to unknown, matching the Core Search service.
page_sizeThe number of verse results to return in the collection. Must be between 1 and 99.
page_tokenThe page token to retrieve results from.
Search the Platform for Bible verses. › Responses
Successful request
user_intentThe intent the Core Search service resolved for the query.
did_you_meanAlternative spellings the search service suggests for the query.
search_instead_forA corrected query the results were actually returned for, if any.
next_page_tokenToken to send to the server when retrieving the next page of results.
Search the Platform for verse images.
Search for verse-art images by query, returning a paginated list of images. Each image carries its id and the USFM verse references it illustrates (e.g. 1CO.13.4); image bytes are served by the CDN, not this endpoint. The bible_id determines the language searched, so this endpoint takes no language parameter. Use page_size and page_token to page through the full result set.
query Parameters
queryThe search query string used to find matching results.
bible_idThe Bible version identifier
page_sizeThe number of verse results to return in the collection. Must be between 1 and 99.
page_tokenThe page token to retrieve results from.
Search the Platform for verse images. › Responses
Successful request
next_page_tokenToken to send to the server when retrieving the next page of results.