Home · Resources · Quick start

Three steps to your first payload

No SDK, no proxy config, no login state. Copy three commands.

Step 1 · Sign up and create a key

After signing up, create a key under Tokens in the console and copy it (shown once).

Sign up Already have an account → create key

New accounts: overseas platforms work immediately; mainland platforms (Douyin / Xiaohongshu) include 5 free trial calls, then a top-up unlocks the group.

Step 2 · Copy one command

Start with the balance check to confirm the key works, then call a real endpoint.

Step 3 · Read the response, confirm billing

Every response carries cost_usd (this call) and balance_usd (remaining). Failed calls (upstream error, timeout) are not charged and are refunded automatically. Full history lives under Usage in the console.

Three usual causes of a first failure

Copy and run

Python (stdlib, no dependencies)
import os, json, urllib.request

KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
    "https://lucydomi.com/mcp/v1/check_balance",
    data=b"{}",
    headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
    method="POST",
)
print(json.load(urllib.request.urlopen(req, timeout=30)))

Real response sample

Taken from a real production call; truncated, image/signed URLs removed.

{
  "ok": true,
  "quota_usd": 2.89,
  "quota_exact_usd": 2.8935,
  "used_usd": 2.3,
  "group": "ov_video"
}

FAQ

Do I need separate keys for overseas and mainland?
Per group, yes: overseas platforms use an overseas key, Douyin/Xiaohongshu a domestic key. One account can hold both.
How do I wire this into an MCP client?
Add https://lucydomi.com/mcp as an MCP server with the key in the Authorization header; tools are auto-discovered. See the integration guide.
Charged for failures?
No. Only successful data returns are billed.
Where do I see usage?
Usage in the console lists endpoint, time and cost per call; responses also carry cost_usd.

Related

Integration guidePricingTry a keyword searchSee it without signing up

One key, six platforms

Same schema, same MCP endpoint, one parameter to switch platforms. Sign-up credit included, failed calls are free.

See pricing Try it first