DocumentationOverview
Documentation
BuzzTake signs in to social accounts in real browsers and runs what a person can do there. You add an account once, then call one endpoint. These pages cover the REST API and the MCP server; both use the same API key and the same action names.
How it works
- Add an account. Send a password (and a 2FA secret if the account has one), import cookies, or sign in yourself in a live browser. BuzzTake gives the account its own browser profile with a fixed device fingerprint and your proxy.
- Run an action.
POST /v1/accounts/{id}/actionswith atypesuch aspost,likeorsend_message. Every action is a job; passwaitto get the finished result in the same response. - Step in when asked. When a sign-in needs something BuzzTake cannot supply, the action stops at
needs_inputwith a challenge. Answer it by API, by MCP, or open the sign-in link and finish in the live browser.
Hosts
| Host | Serves |
|---|---|
https://api.buzztake.com | The REST API, for API keys. |
https://mcp.buzztake.com/mcp | The MCP server over streamable HTTP. Same API key. |
https://buzztake.com | The web app. /v1/* also answers here for signed-in browser sessions. |
Authentication
Create an API key in the web app under Developer, then send it as a bearer token. Keys start with btk1_. Keep keys on a server: anyone who holds one can act in your accounts.
curl https://api.buzztake.com/v1/credits \
-H "Authorization: Bearer $BUZZTAKE_API_KEY"Pages
Start here
From an API key to a finished action, by REST or by MCP.
Reference
The objects, the actions and the answers you can get back.
- AccountsConnect methods, the account object and its statuses, proxies, devices, checks and sign-in links.
- ActionsEvery action type with its parameters, price and result, batch actions and generic browser steps.
- Errors and challengesAction statuses, error codes and what to do about each, and the sign-in challenges.
Credits and help
What an action costs, how to pay for it, and how to tell us what is missing.
For agents and tools
Plain-text versions of this documentation.