Skip to main content

Developers

Use the public API from your own systems, or let an AI assistant work with Ghostpull through MCP. Both use your account's Addons and media library, with different authentication and available actions.

Public APIMCP
Use it forScripts and integrationsConnected AI assistants
Authenticate withAn account API key in x-api-keyYour Ghostpull login and OAuth consent
Available actionsList Addons, upload and read media, import and read products, analyze and manage brands, start, follow and redo runs and batchesUpload and read media, import and read products, analyze and manage brands, check credits, start and follow runs, read your profile and change your name
Start hereAPI quickstartConnect through MCP
ReferenceAPI reference v1MCP tools

The public API is in preview. Check the live API contract or the connected server's tools/list before relying on an operation.

API​

Start with the API quickstart, then give your key only the permissions it needs. Follow the guides to upload media, start runs, follow them, run batches and make and edit image ads. The API reference describes each operation's fields and responses.

MCP​

Connect an assistant, try a workflow, and see the tool list. The assistant reads each tool's exact inputs and outputs from the server. MCP tools act for the account you connected; account API keys do not work at the MCP endpoint.

To use Ghostpull in the web app, start with the user guides.