API, SMM tools and AI agents
Everything the website does, from code — the REST API, the SMM-compatible endpoint, the MCP server for agents, keys and their safety rails.
Everything the Spoofy website does, a program or an AI agent can do — same catalog, same prices, same balance. Full reference: Developers.
Three ways in
| For | Where | |
|---|---|---|
| REST API | your own code | https://spoofy.social/api/v1 — JSON, OpenAPI 3.1 at /api/v1/openapi.json |
| SMM-compatible endpoint | SMM tools that already speak the standard key + action format | https://spoofy.social/api/v2 — actions services, add, status, refill, cancel, balance |
| MCP server | AI agents (Claude, Cursor, VS Code and any MCP client) | https://spoofy.social/mcp — Streamable HTTP |
Browsing the catalog, checking a link and getting a quote need no key. A TypeScript SDK (@fimi/sdk) wraps the REST API.
API keys
- Create and revoke keys in your dashboard under Developers. The full key (it starts with
fimi_live_) is shown once. - Send it as
Authorization: Bearer fimi_live_…. - Up to 20 active keys per account. Keys can only be made from the signed-in dashboard: a key can't create keys or manage webhooks.
Safety rails for every key
- Read-only keys can browse, quote and read orders, but never spend.
- Daily cap (per UTC day, net of refunds) and per-order cap, in US dollars.
- Platform allow-list — e.g. only X and TikTok.
- Dry runs —
"dry_run": truechecks and prices an order and charges nothing. - Idempotency — send an
Idempotency-Keywith every order; a retry returns the first order, never a second charge. - Orders made with a key are labelled with it in the dashboard. No key can withdraw money.
Several orders at once
POST /api/v1/orders/batch takes up to 25 orders and pays for them together: every one is checked first, and if any one can't go, none is placed and each says why. The website's cart and your saved links are in the API too (/api/v1/cart, /api/v1/links/saved), so an agent can fill a cart for you to check and pay.
AI agents
The MCP tools: find_services, get_quote, place_order, place_orders (several at once), get_order, list_orders, request_refill, cancel_order, get_balance and get_top_up_info. place_order and place_orders never charge unless the agent passes confirm: true after you agreed to the price. Install lines for each client are on Developers.
Machine-readable docs
/llms.txt, /llms-full.txt (all the developer docs and this help center in one file) and the OpenAPI document.
Didn’t answer it?
Ask the chat — it can also check your own orders when you’re signed in.