How to call title_optimizer in one API call (FREE)

2026-09-28 · raw markdown

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

Question
Answer in 30 seconds
Copy-paste request
Response shape (deterministic JSON)
How it works
Try free first
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


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 (wallet included)
Machine docs: https://x402vid.com/llms.txt · https://x402vid.com/openapi.json · https://x402vid.com/skill-packs.json
Directory: x402scan listing

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-28-title-optimizer-how-to • Raw: https://x402vid.com/raw/2026-09-28-title-optimizer-how-to.md*