Insight Timer

Language filter for content, as ISO 639-1 codes. FORMAT: - Single code: "en" - Multiple codes: comma-separated: "fr,de,en" DEFAULT BEHAVIOR (IMPORTANT): - Infer language from the user's language or apply the user's provided value when they explicitly specify it. If the result is empty, don't use this filter. RULES: - Use only ISO 639-1 lowercase codes. - Do not include region variants like "en-US".

Filter by content format. Must be exactly 'guided', 'talks', or 'music' (case-sensitive). - 'guided': Teacher-led meditation practices (body scans, breathwork, visualizations, mindfulness exercises, sleep meditations etc) - 'talks': Teachings, dharma talks, lectures on meditation, spirituality, philosophy, psychology, and wellbeing topics - 'music': Instrumental tracks with no voice (sleep music, ambient, nature sounds, binaural beats, focus music, relaxation music) Omit this parameter to search across all three content types. INTENT HEURISTICS (IMPORTANT): - If the user asks to learn/understand/explain/teach me: set contentType = "talks". - If the user asks to listen to a guided meditation session: set contentType = "guided". - If the user clearly wants BOTH learning + practice (e.g., "teach me about Buddhist meditation"): OMIT contentType (search across all types). - If the user asks for sounds/music: set contentType = "music".

Filter by content duration in minutes. Format: 'AtoB' where A and B are positive integers. Common ranges: - '0to5': Quick (under 5 minutes) - micro-practices, short breathing exercises - '5to10': Brief (5-10 minutes) - quick sessions - '10to20': Standard (10-20 minutes) - typical meditation length - '20to30': Medium (20-30 minutes) - '30to60': Long (30-60 minutes) - deeper practices - '60to': Hour+ (60 minutes and above) - extended sessions, sleep music Open-ended: Use 'Xto' (e.g., '30to') for "X minutes or longer", or '0toY' (e.g., '0to15') for "up to Y minutes". Examples: - '5to15' finds 5-15 minute content, '45to' finds 45+ minute content. - "Find a 10-minute meditation for beginners" -> query: "beginner meditation", lengthRange: "8to12" - "Play hour-long nature sounds" -> query: "nature sounds", contentType: "music", lengthRange: "60to" Note: Most content is 10-30 minutes. Sleep music and extended practices can reach 1-3+ hours. Omit this parameter if duration isn't specified.

Page number for pagination. Use this ONLY when the user asks for 'more options' or additional results from the SAME search. When used, keep all other parameters identical to the previous request and set 'page' to the 'nextPage' value returned by the prior response. Omit this field (or treat as page 1) for any new or modified search. Never recommend to pull next page explicitly.

Filter by teacher/publisher name (exact or partial). Use this when the user explicitly requests a teacher/publisher (e.g., "by Jack Kornfield"). When provided, keep the query focused on the topic and omit voiceGender.

Natural language search for meditation and wellbeing-themed content. QUERY RULES (IMPORTANT): - Keep queries broad unless the user explicitly asked for something narrow. - Prefer 1–3 core keywords (topic/tradition/practice) over long phrases. - Use the user's language as-is for the initial search. Do NOT translate to English. - If the user explicitly requests a language, translate the query into that language for the first call (e.g., "sleep meditation in Spanish" -> query: "dormir"). - Do NOT add extra techniques (e.g., "breathwork", "body scan", "somatic") unless the user asked for them or they are directly related to the user's request. - Do NOT add quality modifiers like "best", "top-rated", "popular" — the backend handles ranking. - Do NOT include durations (minutes/hours) in the query. Put duration ONLY in lengthRange. - If a publisher/teacher name is specified, keep the query to the topic only and put the name in publisherName. - Omit query only when the user asks for a teacher/publisher with no topic. - If the first search returns no results, retry once with the query translated to English (keep other filters the same). MORE OPTIONS / PAGINATION (IMPORTANT): - If the user asks for "more", "more options", "more like that", "show me more", or similar, treat it as the SAME search. - Keep the SAME query and the SAME filters, and request the next page using the pagination parameter (e.g., `page` from the prior response's `nextPage`). - ONLY if there are no more pages (or results are repeating) you MAY rotate the query slightly to fetch additional relevant results. - Rotation must remain within the SAME intent/topic (near-synonyms or closely related terms). - Change at most ONE keyword; keep it broad and minimal (1–3 keywords). - Do NOT introduce new techniques or formats the user didn't ask for. - Examples of safe rotations: - "sleep" -> "insomnia" / "bedtime" / "deep sleep" - "anxiety" -> "stress" / "calm" / "worry" - "focus" -> "concentration" / "study" / "productivity" - When rotating, reset pagination to the first page. IMPORTANT: Pass a single query string unless the user's request truly, explicitly, and unambiguously requires searching for multiple distinct topics at once. Only in such rare cases, concatenate multiple queries with a comma (",")—otherwise, always use a single query. Prefer minimal examples: - "sleep" - "anxiety" - "grief" - "loving-kindness" - "mindfulness basics" - "buddhist meditation" - "nature sounds" - "yoga nidra" If and only if the user clearly requests multiple, separate searches (e.g., "Find meditations for sleep, anxiety, and focus"), concatenate each query with a comma: "sleep, anxiety, focus". Otherwise, keep as a single query.

Filter by teacher's voice gender for guided meditations and talks. Must be exactly 'MALE' or 'FEMALE' (case-sensitive). IMPORTANT: Do NOT apply this filter when contentType is 'music'—instrumental tracks have no voice/teacher. IMPORTANT: Do NOT apply this filter when publisherName is provided or the user requests a specific teacher/publisher. Use when user specifies gender preference ("female voice", "male teacher") or omit to show all voices.

A JSON string representing an array of events to log. Each event object should include event_name and event_params. Example: [ { "event_name": "click", "event_params": { "click_event_name": "foo", "library_item_id": "123" } } ] Event params by event type: - click: { click_event_name: string, library_item_id: string (optional) } - impression: { impression_event_name: string, library_item_id: string (optional) } - error_event: { error_event_name: string, error_message: string, error_stack: string }