{"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. Call with no parameters (or ?help=1) for this manifest; add `q` and/or filters to search.","endpoint":"https://elonmuskarchive.org/agents","method":"GET","recommendedFlow":"1) GET /agents?q=… → ranked results, each with `passages` (windowed text around the matches). 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) 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).","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.","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.","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."},"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)","url":"canonical page on the site","source":"original source URL | null","embedUrl":"embed URL (YouTube/X) | null","hasTranscript":"boolean","hasBody":"boolean","transcriptUrl":"endpoint for the full text | null (see /api/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?q=mars%20colonization&type=interview&limit=5","https://elonmuskarchive.org/agents?q=%22full%20self-driving%22&org=Tesla&sort=date_desc","https://elonmuskarchive.org/agents?q=ai%20-politics&from=2023-01-01&fields=transcript,body","https://elonmuskarchive.org/agents?q=neuralink&matches=3&context=500  (read several passages per hit)","https://elonmuskarchive.org/agents?type=post&has=media&sort=date_desc&limit=10"],"facets":{"total":1567,"byType":{"speech":11,"interview":153,"email":36,"post":1310,"keynote":57},"orgs":["Neuralink","OpenAI","SpaceX","Tesla","Twitter","xAI"],"dateRange":{"from":"2011-08-15","to":"2026-06-21"}},"related":{"excerpt":"https://elonmuskarchive.org/agents/excerpt?id={id}&q={keywords}","transcripts":"https://elonmuskarchive.org/api/transcripts"}}