---
title: "How to call transcript_markdown in one API call (FREE)"
slug: 2026-10-03-transcript-markdown-how-to
description: "How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/transcript_markdown, free (x402/Base). Returns styled Markdown fi"
date: 2026-10-03T14:04:27.933247+00:00
author: x402vid
tags: ["x402vid", "transcript_markdown", "how-to", "youtube", "ai-agents", "x402", "pay-per-call"]
canonical_url: https://x402vid.com/blogs/2026-10-03-transcript-markdown-how-to
reading_time_minutes: 2
llm_summary: "How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/transcript_markdown, free (x402/Base). Returns styled Markdown fi"
---

> **TL;DR for AI:** How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/transcript_markdown, free (x402/Base). Returns styled Markdown fi
>
> **Key entities:** x402vid, x402vid, transcript_markdown, how-to, youtube

<!-- llm-toc -->
## Table of Contents
- [Question](#question)
- [Answer in 30 seconds](#answer-in-30-seconds)
- [Copy-paste request](#copy-paste-request)
- [Response shape (deterministic JSON)](#response-shape-deterministic-json)
- [How it works](#how-it-works)
- [Try free first](#try-free-first)
- [Key Takeaways](#key-takeaways)

## Question
How-to walkthrough a developer runs in 2 minutes.

## Answer in 30 seconds
POST `/tools/transcript_markdown` on `https://x402vid.com`. Price: **free** per call (x402, Base `eip155:8453`). Best for: saving research dossiers agents share.

## Copy-paste request
```bash
curl -s -X POST https://x402vid.com/tools/transcript_markdown \
  -H 'Content-Type: application/json' \
  -d '{"video_url": "https://www.youtube.com/watch?v=VIDEO_ID"}'
```

Returns 200 directly — no payment header, no wallet. Graduate anytime: paid calls start at $0.01 (`search_and_rank_videos`).

## Response shape (deterministic JSON)
Returns styled Markdown file with timestamp links. Keys are versioned and stable so agents can pipe output
straight into the next step. Error payloads return error JSON — nothing to settle, calls are free.

## How it works
1. POST the request below to `/tools/transcript_markdown`.
2. Structured JSON returns immediately — no payment header, no wallet, no 402.
3. Graduating to a paid endpoint later? That call returns 402 first: sign with your wallet, retry with `X-PAYMENT`.

## Try free first
- `GET https://x402vid.com/health` — liveness + live per-tool prices
- `POST https://x402vid.com/tools/video_preview` — free taster with transcript excerpt
- `GET https://x402vid.com/api/v1/trending/top` — free top-3 trending
- No setup: [try x402vid in Poncho](https://tryponcho.com/m/x402vid.com) (wallet included)
- Machine docs: [https://x402vid.com/llms.txt](https://x402vid.com/llms.txt) · [https://x402vid.com/openapi.json](https://x402vid.com/openapi.json) · [https://x402vid.com/skill-packs.json](https://x402vid.com/skill-packs.json)
- Directory: [x402scan listing](https://www.x402scan.com/server/788e9347-cf25-4b72-b4c5-624a67549ab2)

## Key Takeaways
- transcript_markdown is free: no wallet, no payment header, no subscription.
- Copy the request above; it returns 200 directly.
- Graduating? Cheapest paid call is $0.01 (`search_and_rank_videos`).

---
*Provenance: x402vid notes • Canonical: https://x402vid.com/blogs/2026-10-03-transcript-markdown-how-to • Raw: https://x402vid.com/raw/2026-10-03-transcript-markdown-how-to.md*