Jove

Jove Search Semantic

Semantic (vector) search over JoVE videos via Pinecone. Best for natural-language queries with optional metadata filters. Use when: query is conversational/conceptual, no author/institution filter needed, filter conditions are simple, top_k ≤ 50. Do NOT use when: exact keyword/phrase match, author or institution filter, section-specific search, complex nested filters, or > 50 results needed. ## Parameters query (str): natural-language query. filter (object, optional): Pinecone metadata fil

Get Highlight Or Most Watched Videos

Retrieves JoVE curated video lists: trending (highlighted) or all-time popular (most_watched), scoped to research or education. highlighted: views over the last 365 days, refreshed every 15 days — what's gaining traction now. most_watched: cumulative all-time views — historically popular content. ## Parameters video_request_type: "highlighted" | "most_watched" context: "research" | "education" top_n (int, optional): number of results to return. lang_code (str, optional): language for l

Jove Search Keyword Filters Aggregations

OpenSearch Query DSL search over JoVE articles. Supports keyword/phrase search, complex filters (author, institution, section, date, views), sorting, and aggregations. Input: a single query_dsl JSON object. Use when: exact keyword/phrase, author or institution filter, section-specific full-text, complex combined filters, analytics/aggregations. Do NOT use when: natural-language query → jove_search_semantic; curated lists → get_highlight_or_most_watched_videos; no clear keywords/filters → jove_s

Jove Search Chapters

Keyword search over JoVE educational chapters. Returns chapter title, section id, summary, product type, associated videos, and page URL. Use when: user asks about chapters, textbook sections, course modules, topic collections, or video groupings. Do NOT use when: searching individual videos → use jove_search_semantic or jove_search_keyword-filters-aggregations. ## Parameters query (str): keyword or phrase describing the chapter topic. size (int, optional): number of results to return (max

Jove Search Support

Semantic search over the JoVE Help Center (help.jove.com) via Pinecone. Returns FAQs, how-to guides, tutorials, and troubleshooting articles managed by customer support and product teams in Zendesk. Use when: user has a support question, platform access issue, "how to" question about JoVE features, or needs troubleshooting help. Do NOT use when: searching for scientific videos/articles → use jove_search_semantic; searching educational chapters → use jove_search_chapters. ## Parameters query

Jove Lookup Account Eligibility

Look up JoVE account / free-trial eligibility for an email via the trials checkEmail API. Validates whether an email can start a free trial, already has JoVE access, is a personal (non-institutional) address, or needs a different path (institutional email, existing subscriber handling, support search). Call only after the user provided an email. This upstream call may log a trials funnel event — do not call speculatively. Use when: user asks for a free trial, institutional access, subscriptio