YouVersion PlatformYouVersion Platform
PlatformBiblesDev Docs
CommunityPartnersSupport

YouVersion Platform

Build applications and integrate with the world's most popular Bible platform.

Platform Products

  • Platform Portal
  • Developer Documentation
  • App Management

Resources

  • Support
  • Press inquiries

Legal

  • Privacy Policy
  • Terms of Use

© 2026 YouVersion. All rights reserved.

  • Overview
  • API Reference
  • SDKs
  • Changelog
<  Back to Platform
data exchange
    Show the data exchange approval page.getComplete the data exchange approval flow.postCreate a data exchange token.post
bibles
    Get a Bible collectiongetGet a Bible's datagetGet the index for a BiblegetGet a passage of Bible textgetGet a Book collection for a BiblegetGet a Book's datagetGet a Chapter collection for a BookgetGet a Chapter's datagetGet a Verse collection for a ChaptergetGet a Verse's dataget
fonts
    Get a collection of fonts supported in the Platform.getGet details about a specific font family in the Platform.getGet a browser-consumable stylesheet for a specific font family.get
highlights
    Get a collection of highlights for a user.getCreate or update a highlight on a passage.postClear highlights for a passage.delete
languages
    Get a collection of languages supported in the Platform.getGet details about a specific language in the Platform.get
licenses
    Get a collection of licensesget
permissions
    Get permissions granted to an app.get
organizations
    Get a collection of organizations in the Platform.getGet details about a specific organization in the Platform.getGet bibles associated with a specific organization in the Platform.get
verse of the days
    Get the verse of the day calendar for an entire year.getGet the verse of the day for a specific day of the year.get
search_queries
    Get suggested or trending search queries.get
search_unified
    Search the Platform for Bible verses and related topics.get
search_topics
    Search the Platform for topics related to a query.get
search_verses
    Search the Platform for Bible verses.get
apps
    Get details about a specific app in the Platform.get
Schemas
Transformers
Transformers

search_unified

Endpoint

Search the Platform for Bible verses and related topics.

GET
https://api.youversion.com
/v1/search-unified

Search for Bible verses and related topics 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) when you need to page through the full result set for a single kind.

Search the Platform for Bible verses and related topics. › query Parameters

query
​string · minLength: 1 · maxLength: 100 · required

The search query string used to find matching results.

bible_id
​integer · int32 · required

The Bible version identifier

Example: 3034
language_ranges[]
​string[] · required

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_intent
​string · enum

The searcher's intent. Defaults to unknown, matching the Core Search service.

Enum values:
unknown
topical
text
reference
Default: unknown
fields[]
​string[]

Result kinds to include: verses and/or topics. Use bracket notation to pass multiple values, for example fields[]=verses&fields[]=topics. Omit to return all kinds. Query metadata is always included.

Search the Platform for Bible verses and related topics. › Responses

Successful request

A single unified, unpaginated set of search results grouped by kind: verse references and related topics. Returns one combined page of top results per kind; there is no page_size or page_token. Use the kind-specific endpoints (search-verses, search-topics) to page through the full result set for a kind.
​object[] · readOnly · required
​object[] · readOnly · required
user_intent
​string | null · required

The intent the Core Search service resolved for the query.

Example: text
did_you_mean
​string[] · required

Alternative spellings the search service suggests for the query.

Example: ["water","war"]
search_instead_for
​string | null · required

A corrected query the results were actually returned for, if any.

GET/v1/search-unified
curl --request GET \ --url 'https://api.youversion.com/v1/search-unified?query=%3Cstring%3E&bible_id=%3Cnumber%3E&language_ranges%5B%5D=%3Cvalue%3E'
shell
Example Responses
{ "verses": [ { "reference": "JHN.3.16" } ], "topics": [ { "id": 42, "text": "faith", "subtopics": [ "trust", "belief" ] } ], "user_intent": "text", "did_you_mean": [ "water", "war" ], "search_instead_for": "search_instead_for" }
json
application/json

search_queriessearch_topics