Skip to main content
Every phantombuster.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.
New to Corsair? See API access, authentication, and error handling.

Agents

delete

agents.delete Delete a PhantomBuster agent by ID Risk: destructive
Input Output: empty object

fetch

agents.fetch Get details for a specific PhantomBuster agent by ID Risk: read
Input Output

fetchAll

agents.fetchAll Get all PhantomBuster agents (Phantoms) in the organization Risk: read
Input: empty object Output: object[]

fetchDeleted

agents.fetchDeleted Get all deleted agents in the organization Risk: read
Input: empty object Output: object[]

fetchOutput

agents.fetchOutput Get the output of the most recent container for an agent, including status, progress, console log, and result object Risk: read
Input Output

launch

agents.launch Add a PhantomBuster agent to the launch queue Risk: write
Input
Output

launchSoon

agents.launchSoon Schedule a PhantomBuster agent to launch before a specific time Risk: write
Input
Output: empty object

save

agents.save Create a new agent or update an existing one Risk: write
Input
Output

stop

agents.stop Stop a currently running PhantomBuster agent Risk: write
Input Output

unscheduleAll

agents.unscheduleAll Disable automatic launch for all agents in the organization Risk: write
Input: empty object Output: empty object

Branches

create

branches.create Create a new branch Risk: write
Input Output

delete

branches.delete Delete a branch by ID Risk: destructive
Input Output: empty object

fetchAll

branches.fetchAll Fetch all branches in the organization Risk: read
Input: empty object Output: object[]

fetchDiff

branches.fetchDiff Get the staging/release diff for script branches Risk: read
Input Output: object[]

release

branches.release Release a script branch Risk: write
Input Output: empty object

Containers

fetch

containers.fetch Get details for a specific run container by ID Risk: read
Input Output

fetchAll

containers.fetchAll Get all run containers for a specific agent Risk: read
Input Output

fetchOutput

containers.fetchOutput Get the console output for a specific container Risk: read
Input Output

fetchResultObject

containers.fetchResultObject Get the result object (JSON data) from a specific container Risk: read
Input Output

Identities

generateToken

identities.generateToken Generate an identity token Risk: write
Input: empty object Output

saveEvent

identities.saveEvent Save an identity event Risk: write
Input
Output: empty object

Leads

deleteMany

leads.deleteMany Delete multiple leads by their IDs Risk: destructive
Input Output

fetchByList

leads.fetchByList Fetch leads belonging to a specific lead list Risk: read
Input
Output

save

leads.save Save a single lead to PhantomBuster org storage Risk: write
Input
Output

saveMany

leads.saveMany Bulk-save multiple leads to PhantomBuster org storage Risk: write
Input
Output: object[]

Lists

delete

lists.delete Delete a lead list by ID Risk: destructive
Input Output

fetch

lists.fetch Get details for a specific lead list by ID Risk: read
Input Output

fetchAll

lists.fetchAll Get all lead lists in the organization Risk: read
Input: empty object Output: object[]

save

lists.save Create a new lead list or update an existing one Risk: write
Input Output

Misc

fetchIpLocation

misc.fetchIpLocation Retrieve the country of an IP address Risk: read
Input Output

requestAiCompletion

misc.requestAiCompletion Request a text completion from the AI module Risk: write
Input
Output

solveHCaptcha

misc.solveHCaptcha Solve an hCaptcha challenge Risk: write
Input Output

solveRecaptcha

misc.solveRecaptcha Solve a reCAPTCHA challenge (v2 or v3) Risk: write
Input Output

Orgs

exportAgentUsage

orgs.exportAgentUsage Export agent usage CSV for the organization Risk: read
Input Output: string

exportContainerUsage

orgs.exportContainerUsage Export container usage CSV for the organization Risk: read
Input Output: string

fetch

orgs.fetch Get the current organization info Risk: read
Input Output

fetchAgentGroups

orgs.fetchAgentGroups Get agent groups and order for the organization Risk: read
Input: empty object Output: object[]

fetchResources

orgs.fetchResources Get the organization resource usage (slots, limits) Risk: read
Input: empty object Output

fetchRunningContainers

orgs.fetchRunningContainers Get the organization’s running containers Risk: read
Input: empty object Output

saveAgentGroups

orgs.saveAgentGroups Update agent groups and order for the organization Risk: write
Input
Output

Scripts

delete

scripts.delete Delete a script by ID Risk: destructive
Input Output: empty object

fetch

scripts.fetch Fetch a script by ID Risk: read
Input Output

fetchAll

scripts.fetchAll Fetch all scripts for the current user Risk: read
Input Output: object[]

fetchCode

scripts.fetchCode Get the code of a script Risk: read
Input Output

save

scripts.save Create a new script or update an existing one Risk: write
Input Output

updateAccessList

scripts.updateAccessList Update a script’s access list Risk: write
Input Output: empty object

updateVisibility

scripts.updateVisibility Update the visibility of a script Risk: write
Input Output: empty object

Storage

deleteLeadObjects

storage.deleteLeadObjects Delete lead objects from organization storage Risk: destructive
Input Output

saveCompanyObject

storage.saveCompanyObject Save a company object to organization storage Risk: write
Input
Output

saveLeadObject

storage.saveLeadObject Save a lead object to organization storage Risk: write
Input
Output

saveManyCompanyObjects

storage.saveManyCompanyObjects Bulk-save company objects to organization storage Risk: write
Input
Output: object[]

saveManyLeadObjects

storage.saveManyLeadObjects Bulk-save lead objects to organization storage Risk: write
Input
Output: object[]

searchCompanyObjects

storage.searchCompanyObjects Search company objects in organization storage Risk: read
Input Output: object

searchLeadObjects

storage.searchLeadObjects Search lead objects in organization storage Risk: read
Input Output: object

Users

fetchMe

users.fetchMe Get info about the currently authenticated PhantomBuster user Risk: read
Input Output

updateMe

users.updateMe Update the current user’s info Risk: write
Input Output: empty object