API reference

All 595 endpoints of the Pluto Ads API, generated from its OpenAPI document. How authentication, commands, jobs and lists work is in the Public API guide; error codes are in API errors.

The examples read the base URL and an API key from two variables:

Terminal
export PLUTO_API=https://api.plutoads.ai/api/v1
export PLUTO_KEY=sk_…

Launch ads

Media

Automate

Measure

Collaborate

Connect

Developers

Workspace and people

Billing and operations

Protocol

More

Brand terms1 endpointThe workspace, members and invitations.Changes1 endpointPublishing launches to their ad platform and controlling what is live.Competitors4 endpointsThe in-app Agent: chats with streamed answers, approvals for publish and admin actions, metered in the organization's usage (see Billing).Launch groups9 endpointsLaunches, ad sets and ads with override-only inheritance.Loop folders5 endpointsLoops: a LoopDefinition (the loop builder's flow), its revisions (who changed it: a person, the Agent in a chat, an MCP agent or an API key) and the Agent chat that holds its history, shared with everyone who can see the loop.Loop skills1 endpointLoops: a LoopDefinition (the loop builder's flow), its revisions (who changed it: a person, the Agent in a chat, an MCP agent or an API key) and the Agent chat that holds its history, shared with everyone who can see the loop.Loop templates1 endpointLoops: a LoopDefinition (the loop builder's flow), its revisions (who changed it: a person, the Agent in a chat, an MCP agent or an API key) and the Agent chat that holds its history, shared with everyone who can see the loop.Mirrors2 endpointsConnections: the ad platforms (GET /platforms) and the store's profit (Pluto Profit).Social5 endpointsComments on the posts your ads run as (on Meta, Facebook and Instagram posts): read, reply, hide, unhide and delete, as far as the platform allows.Views10 endpointsViews: what a person sees on a list page (Launches, Media, Analytics, Loops, Inbox) as one view state of filters, grouping, ordering and display that is the page's URL, checked against the page's schema, and saved views, personal or shared with the workspace.