Skip to content

satchitananda

Developers

Everything here is free to read, use and link to. There’s no key and no sign-in.

The OpenAPI description, the API catalog andthis reference in Markdown say the same.

One public, read-only endpoint, GET /api/v1/search/, that searches the guided meditations on https://sat-chit-ananda.com/: by their words, and by meaning. The site’s own search page uses it. The OpenAPI description is https://sat-chit-ananda.com/openapi.json.

No key, no sign-in, no cookies. Nothing about who searched is stored or logged. The day’s total of searches is counted. The words of a search that found nothing are counted by day, as ideas for what to make next. To match by meaning, the words are sent once to Google’s embedding model (gemini-embedding-001), with nothing about who sent them.

Limits. 100 searches per address per day (UTC). Over that, a 429 with Retry-After until midnight UTC.

GET https://sat-chit-ananda.com/api/v1/search/?q=help+me+fall+asleep&limit=3
ParameterWhat it doesValues
q (or query, search)What to look for, in your own words: what it is for, how you feel, or a line you remember.2 to 200 characters, required
kind (or type)What to search. Meditations today; more kinds will come.meditation, default meditation
for (or playlist)Only those in this playlist (its slug), as the Meditations page’s For filter.
soundOnly those with this natural sound (rain, ocean, forest), as the Meditations page’s Sound filter.
lengthOnly those of this length, in whole minutes as the cards show.under-20, 20-30, over-30
settingOnly those for this setting: in bed, or sitting or lying down.bed, sit-or-lie
voiceOnly those read in this kind of voice (the first voice you hear).male, female
purposeOnly those for this purpose, as their label says: for sleep, or to stay alert.sleep, alert
limit (or per_page, page_size)How many results to answer with.1 to 50, default 10
offsetHow many to skip: the previous answer’s next_offset.0 to 1000, default 0
prefixWhile someone types: the last word also matches as the start of a word.default false

Every result has:

  • its page (url)
  • direct audio links (audio.m4a, audio.mp3, audio.flac)
  • its length (duration_seconds, length), its voices and its playlists
  • match: the passage that matched, the character ranges of its matched words, the part of the track it’s from (chapter.title, and chapter.at in seconds), and whether words, meaning or both found it

facets says how many results each filter value would leave. next_steps says where to go next: the top result’s audio and page, and the next page of results. When matching by meaning is unavailable, "degraded": "words only" says so.

Errors

Every error is JSON with:

  • error: what went wrong
  • suggestion: what to do instead
  • next_steps: where to go instead
  • did_you_mean: when something sent was close to a known name or value
StatusWhen
400A parameter is missing, out of range, or not one the API knows
405Anything but GET or HEAD
429Over the day’s 100 searches from this address; Retry-After is the seconds until midnight UTC
503Search is busy; Retry-After says how long to wait

Unknown paths under /api/ answer JSON 404 with where to go instead. There’s no key, no sign-in and no MCP server.

Give your agent this

Use sat-chit-ananda.com, a free library of guided meditations. Start at https://sat-chit-ananda.com/llms.txt. To find one, call GET https://sat-chit-ananda.com/api/v1/search/?q=<what it's for> (no key). Each result has its page, its length and its audio links.

For agents

Every page and its dates

sitemap.xml lists every page with the day it last changed. sitemap.json lists the same pages, each with these fields:

title
The page's HTML <title>, exactly as the page renders it.
created
Date the page was first published.
contentUpdated
Date the page's writing last changed in a way the editor judged meaningful. Typo fixes do not move it.
pageUpdated
Date anything specific to this page last changed: writing, page styles, or title, description and other metadata. Equals sitemap.xml lastmod.

Podcast feeds

Open data