{"name":"Elon Musk Archive — Search API","description":"Advanced keyword search over the reference archive of Elon Musk (interviews, keynotes, speeches, posts and emails, in English, French and German). Built for AI agents: structured filters, ranked results, windowed passages and pagination. Read-only, open CORS. GET /agents (or ?help=1) for this manifest; GET /agents/search with `q` and/or filters to search.","endpoint":"https://elonmuskarchive.org/agents/search","method":"GET","recommendedFlow":"1) GET /agents/search?q=… → ranked results, each with `passages` (windowed text around the matches), `citation` (ready-to-paste source line) and `hasTimings`. This is usually enough to answer WITHOUT any further fetch. 2) Need a bit more around a hit? Follow `excerptUrl` (it carries id+q) or call /agents/excerpt?id=…&q=…&window=…&max=… for just that region. 3) Making a SUBTITLED VIDEO CLIP? Filter to entries with word-level timing (`has=timings`), then call /agents/excerpt?id=…&q=…&timestamps=1 → each passage comes back with `tStart`/`tEnd` (seconds into the `source` video, for `yt-dlp --download-sections`), the dominant `speaker`, and per-word timings (`words: [{w,s,e}]`) to drive a karaoke-style active-word highlight. 4) Only fetch the full transcript (`transcriptUrl`) when you truly need the whole text — check `approxTokens` first to gauge the cost. Tune passage size with `context` (chars) and `matches` (how many passages per result); use `snap=sentence` for clean, quotable passage boundaries.","parameters":{"q":"Keywords. Space-separated terms are AND-combined. Use \"quotes\" for exact phrases and a leading - to exclude (e.g. q=mars \"starship\" -tesla). Accent- and case-insensitive.","type":"Comma list, filter by kind. One or more of: interview, keynote, speech, post, email (url slugs interviews/keynotes/speeches/posts/emails also accepted).","org":"Comma list, filter by organisation. One or more of: Neuralink, OpenAI, SpaceX, Tesla, Twitter, xAI.","from":"Lower date bound, inclusive (YYYY-MM-DD).","to":"Upper date bound, inclusive (YYYY-MM-DD).","fields":"Comma list, restrict where keywords are matched. One or more of: title, summary, body, transcript. Default: all.","has":"Comma list, keep only entries that have: transcript, body, embed, media, timings. `timings` = word-level timestamps available (required for subtitled-clip work; see timestamps=1 on /agents/excerpt).","speaker":"Whose words to match. elon (DEFAULT) = only where Elon himself said/wrote the keywords (his transcript turns, his emails, his own posts); all = anyone (no speaker restriction). Speaker attribution comes from labelled transcripts and per-email authorship; unlabelled videos count as Elon. Use speaker=all to also match interviewers, co-panelists, email counterparts and reposted tweets.","lang":"Language of the returned title/summary/passages: en (default), fr, de. Matching always spans all languages.","sort":"relevance (default when q is set), date_desc (default otherwise), date_asc.","limit":"Page size, 1–100. Default 20.","offset":"Number of results to skip (pagination). Default 0.","exclude":"Comma list of entry ids to omit. Pass the ids you've already used so results aren't repetitive (de-duplication).","snippet":"1 (default) to include passages around the matches, 0 to omit (lightest).","context":"Characters of context per passage (80–2000, default 300). Larger = more text per hit.","matches":"Max passages returned per result (1–5, default 1). Raise to read several hits at once.","snap":"word (default) or sentence. `sentence` aligns passages to sentence boundaries — cleaner, more quotable excerpts."},"resultShape":{"id":"string — stable entry id","type":"interview | keynote | speech | post | email","date":"YYYY-MM-DD","org":"string | null","title":"string (requested lang)","summary":"string (requested lang)","sourceLabel":"string | null — human source name (e.g. 'The Joe Rogan Experience', 'TED')","citation":"string | null — ready-to-paste source line, e.g. 'The Joe Rogan Experience, May 7, 2020'","url":"canonical page on the site","source":"original source URL (the video to download) | null","embedUrl":"embed URL (YouTube/X) | null","hasTranscript":"boolean","hasBody":"boolean","hasTimings":"boolean — word-level timestamps exist (use timestamps=1 on /agents/excerpt)","transcriptUrl":"endpoint for the full text | null (see /agents/transcripts)","excerptUrl":"endpoint to fetch MORE context for this entry (id+q prefilled) without the whole text | null","textLength":"number — characters of full text available","approxTokens":"number — approximate cost (~chars/4) of fetching the full text","score":"number — relevance score (higher = better)","matchedIn":"string[] — fields where a term matched","passages":"array of { field, text, start, end } — windowed context around the matches (the token-saving payload)","snippet":"string | null — first passage (back-compat)"},"responseShape":{"query":"object — the parsed parameters actually applied","total":"number — total matches before pagination","count":"number — results returned in this page","results":"array of result objects (see resultShape)"},"examples":["https://elonmuskarchive.org/agents/search?q=mars%20colonization&type=interview&limit=5","https://elonmuskarchive.org/agents/search?q=%22full%20self-driving%22&org=Tesla&sort=date_desc","https://elonmuskarchive.org/agents/search?q=ai%20-politics&from=2023-01-01&fields=transcript,body","https://elonmuskarchive.org/agents/search?q=neuralink&matches=3&context=500  (read several passages per hit)","https://elonmuskarchive.org/agents/search?type=post&has=media&sort=date_desc&limit=10","https://elonmuskarchive.org/agents/search?q=mars&has=timings&snap=sentence&exclude=lex-fridman-2023  (clip-ready hits, skip an already-used one)","https://elonmuskarchive.org/agents/search?q=free%20speech&speaker=all  (also match interviewers/co-panelists/email counterparts, not just Elon)"],"facets":{"total":85708,"byType":{"post":85383,"keynote":58,"space":14,"speech":20,"interview":158,"email":47,"earnings":18,"commentary":10},"orgs":["Neuralink","OpenAI","SpaceX","Tesla","Twitter","xAI"],"dateRange":{"from":"2003-04-22","to":"2026-07-29"}},"related":{"excerpt":"https://elonmuskarchive.org/agents/excerpt?id={id}&q={keywords}","transcripts":"https://elonmuskarchive.org/agents/transcripts"}}