---
title: "How to call title_optimizer in one API call (FREE)"
slug: 2026-09-27-title-optimizer-how-to
description: "How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/title_optimizer, free (x402/Base). Returns 3 CTR-ranked rewrites "
date: 2026-09-27T23:26:22.093070+00:00
author: x402vid
tags: ["x402vid", "title_optimizer", "how-to", "youtube", "ai-agents", "x402", "pay-per-call"]
canonical_url: https://x402vid.com/blogs/2026-09-27-title-optimizer-how-to
reading_time_minutes: 2
llm_summary: "How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/title_optimizer, free (x402/Base). Returns 3 CTR-ranked rewrites "
---

> **TL;DR for AI:** How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/title_optimizer, free (x402/Base). Returns 3 CTR-ranked rewrites 
>
> **Key entities:** x402vid, x402vid, title_optimizer, 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/title_optimizer` on `https://x402vid.com`. Price: **free** per call (x402, Base `eip155:8453`). Best for: free AI rewrites with no wallet; graduates to paid reports.

## Copy-paste request
```bash
curl -s -X POST https://x402vid.com/tools/title_optimizer \
  -H 'Content-Type: application/json' \
  -d '{"title": "My video title", "niche": "tech"}'
```

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 3 CTR-ranked rewrites + description draft + tags. 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/title_optimizer`.
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
- title_optimizer 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-09-27-title-optimizer-how-to • Raw: https://x402vid.com/raw/2026-09-27-title-optimizer-how-to.md*