latestOpenAPI 3.0.02026-08-203145159.1 KB

0e40a805593b

search

Search the Thrive content library

Search the entire Thrive content library — Resets, Stories, Microsteps, Courses, Podcasts, Journeys, Challenges, Soundscapes, Bedtime Stories, and Meditations — in a single request. Every match is returned as a complete, ready-to-render item, so there are no follow-up by-id calls to make.

Thrive Search is a premium capability of the Partner API. To enable it for your organisation, contact your Thrive Global representative. Once enabled, your existing bearer token unlocks this endpoint automatically — no new credentials required. Requests made before Search is enabled return 403 Forbidden.

Results are returned in relevance order, capped at approximately 20 hits, and are not paginated. This endpoint responds with a bare { data: [...] } array rather than the { message, valid, data } envelope used by the collection endpoints.

get/v1/search

Query parameters

querystring required

Search text (min length 1)

typesstring

Comma-separated content types to search: reset, story, microstep, learnCourse, podcast, journey, challenge, soundscape, bedtime-story, meditation. Omitted = all ten. An unknown value returns 422.

localestring

Locale, forwarded as the thrive-locale header

Response

Search results in relevance order

Example response

{
  "data": [
    {
      "tags": [
        {
          "slug": "sleep",
          "name": "Sleep"
        }
      ],
      "conditions": [
        {
          "slug": "sleep",
          "name": "Sleep"
        }
      ],
      "coreHealthBehaviors": [
        {
          "slug": "sleep",
          "name": "Sleep"
        }
      ]
    }
  ]
}