# SonicAlpha API

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sonicalpha.ai/_mcp/server

## Docs

- [Welcome](https://docs.sonicalpha.ai/get-started/welcome.md)
- [Quickstart](https://docs.sonicalpha.ai/get-started/quickstart.md)
- [Ask vs. Search](https://docs.sonicalpha.ai/concepts/ask-vs-search.md): Two ways to consume the corpus
- [The Data Model](https://docs.sonicalpha.ai/concepts/data-model.md): Podcast → episode → insight
- [Errors, Limits & Versioning](https://docs.sonicalpha.ai/concepts/essentials.md): The operational contract
- [Generate investment ideas](https://docs.sonicalpha.ai/research-recipes/generate-ideas.md)
- [Map the arguments](https://docs.sonicalpha.ai/research-recipes/map-the-arguments.md)
- [Understand market expectations](https://docs.sonicalpha.ai/research-recipes/market-expectations.md)
- [Hear from domain experts](https://docs.sonicalpha.ai/research-recipes/expert-commentary.md)
- [Track narrative shifts](https://docs.sonicalpha.ai/research-recipes/track-narrative-shifts.md)

## API Docs

- API Reference > insights [Search insights](https://docs.sonicalpha.ai/api-reference/insights/search-insights.md)
- API Reference > insights [Get an insight](https://docs.sonicalpha.ai/api-reference/insights/get-insight.md)
- API Reference > insights [Ask a research question](https://docs.sonicalpha.ai/api-reference/insights/ask.md)
- API Reference > insights [Ask (streaming)](https://docs.sonicalpha.ai/api-reference/insights/ask-stream.md)
- API Reference > podcasts [List podcasts](https://docs.sonicalpha.ai/api-reference/podcasts/list-podcasts.md)
- API Reference > podcasts [Get a podcast](https://docs.sonicalpha.ai/api-reference/podcasts/get-podcast.md)
- API Reference > podcasts [List a podcast's episodes](https://docs.sonicalpha.ai/api-reference/podcasts/list-podcast-episodes.md)
- API Reference > episodes [List episodes](https://docs.sonicalpha.ai/api-reference/episodes/list-episodes.md)
- API Reference > episodes [Get an episode](https://docs.sonicalpha.ai/api-reference/episodes/get-episode.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.sonicalpha.ai/openapi.json)
- [OpenAPI YAML](https://docs.sonicalpha.ai/openapi.yaml)