# Podmenti: instructions for AI agents

Podmenti (https://podmenti.com) turns any episode of any public podcast into a transcript with timestamps, from $1.49 an episode, down to 17¢ in bulk. This file is for agents working for a person: assistants, browser agents, scripts. The short version is in https://podmenti.com/llms.txt; the full API is https://podmenti.com/openapi.json.

## What a person usually wants, and how to get it

**"Get me the transcript of this episode."**
1. Find the episode. With a link (Spotify, Apple Podcasts, YouTube, RSS) or a title, open https://podmenti.com and paste it in the search box, or use the API: GET /api/v1/search?q=<link or name> gives a feed_id, then GET /api/v1/shows/{feed_id}/episodes gives each episode's transcript_id and whether a transcript already exists.
2. Read the opening for free at https://podmenti.com/t/{transcript_id} (a preview of the first minutes, no account).
3. The full transcript costs one credit: $1.49 bought on its own, down to 17¢ in a big pack or plan, whether we already hold it or transcribe it now (usually about two minutes). On the website the person pays through Stripe Checkout; no account is needed first. Through the API: POST /api/v1/requests {"show": {"id": feed_id}, "episodes": [{"guid", "url", "title"} from the episode list]} unlocks the episodes we hold and transcribes the rest; add "dry_run": true to see the exact charge first. For one episode we already hold, POST /api/v1/unlock {"transcript": transcript_id} does the same.
4. Read it: GET /api/v1/transcripts/{transcript_id}?format=text for plain text (txt, srt and vtt for timestamped files; json, with timestamps=1 and words=1 for timing). Once unlocked it is free to read again, forever.

**"Find where they talk about X in this episode."** POST /api/v1/ai-search/query: verbatim quotes with timestamps, 1 credit, refunded on failure. The episode has to be transcribed first.

**"Transcripts of a whole show."** One purchase covers every published episode the person doesn't own yet: GET /api/v1/shows/{feed_id}/all quotes it (priced like a pack of exactly that size, down to 17¢ an episode), POST to the same URL spends credits on it, or POST /api/v1/checkout {"show": feed_id} pays for it through Stripe. Everything is unlocked at once and one email arrives when all of it is transcribed (usually hours, at most 48). It is also offered at the top of every show page. Future episodes are not included.

**"Send me every new episode of this show."** POST /api/v1/shows/{feed_id}/follow: each episode published from then on is bought with the person's credits as it comes out and the transcript is emailed to them. Without credits nothing is charged; they get the link by email instead. DELETE the same URL to stop; GET /api/v1/follows lists them.

## Ground rules
- Spending is the person's decision. Show them the price (dry_run, or the prices below) and get a yes before you buy a pack, subscribe, unlock or request anything. Never enter card details on their behalf without that.
- Prefer the API to scraping pages. Every API call needs a key from a free account (https://podmenti.com/login, or POST /api/v1/register/start {"email"}, which emails a one-time link to the person). Keys look like pm_ followed by 32 hex characters; send them as Authorization: Bearer <key>, and keep them out of URLs and logs.
- Do not walk the site to collect transcripts: pages show a preview only, and full text needs an unlock. Finding shows and listing episodes through the API is free in credits, but counts against the daily request allowance (429 when spent).
- To try the output format without paying, use the sample episode, open to everyone: https://podmenti.com/api/v1/transcripts/a7c18c255b33d645?format=json&timestamps=1&words=1
- Quote transcripts with the episode and timestamp, and link https://podmenti.com/t/{transcript_id} as the source.

## Prices
- One credit is one episode of up to 4 hours; a longer one costs one more credit per started 4 hours, quoted before anything is charged.
- Unlock an episode we already hold (full text, timestamps, .txt/.srt/.vtt/JSON, forever): 1 credit. An episode you already unlocked: 0.
- Transcribe an episode nobody has yet: 1 credit, unlock included, on the GPU fast lane (usually ready in about two minutes). Audio that cannot be transcribed is refunded automatically.
- AI Search, one query against one episode: 1 credit.
- Search, show details, episode lists, charts, trending, episode status, reading unlocked transcripts: 0 credits.
- One-time packs (credits never expire): 1 episode $1.49, 5 episodes $3.49, 10 episodes $5, 50 episodes $15, 100 episodes $25, 200 episodes $45, 500 episodes $100, 1,000 episodes $190. More than 1,000: email contact@podmenti.com for a custom pack.
- Monthly plans: Free 0 credits and 1,000 requests/day; Plus $9/month for 40 episodes and 5,000 requests/day; Pro $29/month for 150 episodes and 20,000 requests/day; Business $109/month for 600 episodes and 50,000 requests/day; Studio $269/month for 1,500 episodes and 100,000 requests/day; Network $519/month for 3,000 episodes and 200,000 requests/day. More than 3,000 episodes a month: email contact@podmenti.com for a custom plan.
- Prices page: https://podmenti.com/plans

## Help
- Something wrong, a refund, a bigger pack or plan, or a podcast creator who wants an episode removed: contact@podmenti.com
- Plans for API use (bigger request allowances, cheapest per episode): Plus, Pro, Business, Studio, Network at https://podmenti.com/plans