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_topics

Endpoint

Search the Platform for topics related to a query.

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

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.

Search the Platform for topics related to a query. › query Parameters

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

The search query string used to find matching results.

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.

Search the Platform for topics related to a query. › Responses

Successful request

An unpaginated set of topics related to a query, for pivoting to other verses in the same topic. Backed by Core Search /topics, which returns a fixed set of topics; there is no page_size or page_token. Query metadata (did_you_mean, search_instead_for) is always included.
​object[] · readOnly · required
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 topics were actually returned for, if any.

total_size
​integer · int32 · required

Total number of topics returned in this response. Because the endpoint is unpaginated, this is the full count returned, not a running total across pages.

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

search_unifiedsearch_verses