FreeSaveVideo

FreeSaveVideo supports personal AI agents

Use the REST API or MCP tools to discover supported media services, read a user's points balance and resolve a public media link. This guide is public and requires no login or JavaScript.

Discover capabilities and prices

Read the API's live capability response before starting a task. Website features such as batch downloads, video editing and payments are not all exposed as agent tools.

Ask the user to connect their account

The user creates a scoped credential on the agent authorization page (Chinese account page). They choose permissions, expiry, daily calls, the points ceiling per resolution and whether membership quota can be used.

Use Authorization: Bearer <user-created-credential>. The user can revoke access at any time. Never ask for their password or Clerk session. Public crawling does not authorize account access or spending.

Connect via MCP or REST

MCP endpoint: https://api.freesavevideo.online/agent/mcp

The endpoint uses stateless Streamable HTTP. Use a client that supports an Authorization header with a user-created credential. OAuth-only clients cannot connect using this credential flow; use REST if your agent can make authorized HTTP requests.

Tools: get_capabilities, get_balance, resolve_media, list_payment_products, create_checkout and get_checkout. Only authorized account tools appear in the tool list.

GET /agent/v1/balance
Authorization: Bearer <user-created-credential>

POST /agent/v1/resolve
Authorization: Bearer <user-created-credential>
Content-Type: application/json

{"url":"https://www.tiktok.com/@example/video/123","idempotencyKey":"my_task_123456","videoQuality":"720"}

REST base: https://api.freesavevideo.online. Reuse the same idempotency key for an immediate retry of the same task. Replay follows the existing one-hour window; a retry after that window may charge again. Use a new key for a new task.

Spending and delivery

Successful resolution can spend the user's authorized points or count against an authorized membership quota. Default spending permission is zero points, with membership use disabled. There is no automatic recharge.

The agent saves the file after resolution. Check whether the result is a redirect, tunnel, picker or local-processing result. Media links can expire. Do not report a file as saved until saving completes.

For Direct Bridge services such as TikTok, use the returned direct media URL. If browser fetch is blocked by CORS, use the browser extension or a user browser handoff. Do not silently fall back to an API tunnel.

User-confirmed purchases

List products with list_payment_products (REST: GET /agent/v1/products?kind=credits&provider=wechat). Purchase orders require separate payments:create and payments:read scopes, a currency, a per-order amount ceiling and a daily new-order amount ceiling. Amounts in API requests are minor units: CNY fen or USD cents. Defaults are zero; existing credentials have no purchase permission.

Create an unpaid order with create_checkout (REST: POST /agent/v1/checkouts) using kind, provider, productKey and idempotencyKey. Reuse that key on every retry; order deduplication is durable and a different product conflicts. Present the returned confirmationUrl and amount to the user. The user signs in to the website, reviews the order, confirms it and completes payment.

Query get_checkout (REST: GET /agent/v1/checkouts/<checkoutId>) at most once every 15 seconds. Continue only when readyToContinue is true, based on verified payment fulfillment. A browser return URL does not prove payment. Read balance and resume the original task with the same download permissions; buying membership does not authorize membership use. For a previously failed resolution, use a new task key after checking the failure outcome. Never rerun a completed download outside its one-hour replay window.

This interface does not imply registration or compatibility with every agent platform. Verify your client's transport and credential support.