PhantomBuster is a cloud-based data extraction and automation platform that enables users to automate actions on the web, such as scraping data, generating leads, and automating social media tasks.
PhantomBuster is a cloud-based data extraction and automation platform that enables users to automate actions on the web, such as scraping data, generating leads, and automating social media tasks. On Nagent, PhantomBuster is exposed as a fully-configurable ai web scraping integration that any agent can call — 53 actions, and API key authentication. No code is required to wire PhantomBuster into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use PhantomBuster to automate the kinds of tasks ai web scraping teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire PhantomBuster into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against PhantomBuster, with input parameters and output schema. Drop these into any step of an agent built in Helix.
PHANTOMBUSTER_ABORT_AGENT_V1Tool to abort all running instances of an agent using the legacy v1 API. Use when you need to immediately stop an agent's execution. Supports soft abort for graceful shutdown.
Input parameters
ID of the agent to abort. All running instances of this agent will be stopped.
If true, attempts a soft abort of the agent. Soft abort allows the agent to gracefully finish its current operation before stopping.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_DELETE_AGENTTool to delete an agent by id. Use when you need to remove a PhantomBuster agent. Ensure the agent is not currently running before deletion.
Input parameters
Id of the agent to delete.
ID of the org that is performing the operation (not necessary when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_DELETE_LEAD_OBJECTSTool to delete one or more lead objects from organization storage. Use when you need to remove lead data. Provide either leadObjectId, or both slug and type parameters.
Input parameters
Slug of the object to delete. Must be used together with type parameter.
Type of object to delete. Must be used together with slug parameter.
ID of a lead object to delete. Provide either leadObjectId, or both slug and type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_DELETE_LEADS_MANYTool to delete multiple leads from organization storage. Use when you need to bulk delete leads by their IDs.
Input parameters
List of lead IDs to delete. Each ID must be a valid lead identifier string.
ID of the org that is performing the operation (not necessary when using a third party key)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_DELETE_LISTTool to delete a storage list by id (Beta). Use when you need to remove a list from organization storage.
Input parameters
Id of the list to delete.
ID of the org that is perfoming the operation (not necessary when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_DELETE_SCRIPTTool to delete a script by id. Use when you need to remove a specific script from PhantomBuster. Optionally specify a branch and environment to delete a specific version.
Input parameters
Id of the script to delete.
Branch of the script to delete. Must be 1-50 characters, alphanumeric, underscores, or hyphens.
Enum for script branch environment.
ID of the org that is performing the operation (not necessary when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_AGENTTool to get an agent by its ID. Use when you need to retrieve detailed information about a specific Phantombuster agent, including its configuration, schedule, and execution settings.
Input parameters
Id of the agent to fetch.
Set to "true" if you want to include the agent's script code in the response
Set to "true" if you want to include the agent's slave agents in the response
Set to "true" if you want to return the agent's manifest in the response
Set to "true" if you want to include the agent's sub-slave agents in the response (requires withSlaves=true)
Set to "true" if you want to include the agent_object in the response
ID of the org that is perfoming the operation (not necessary when using a third party key)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_AGENT_CONTAINERSTool to get a list of ended containers for an agent, ordered by date. Use when you need to retrieve the last available output logs from an agent. This is a legacy v1 API endpoint.
Input parameters
ID of the agent from which to retrieve the containers.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_AGENT_OUTPUTTool to get incremental data from an agent including console output, status, progress and messages. This is a legacy v1 API endpoint designed for easy incremental data retrieval. Use outputPos to track position.
Input parameters
ID of the agent from which to retrieve the output, status and messages.
Mode for selecting which agent instance to track.
ID of the specific instance from which to get console output. Required when mode is 'track'.
Return the agent's console output starting from this position. Use for incremental retrieval.
If true, omit the agent's result object from the response to reduce payload size.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_AGENTS_FETCH_ALLTool to fetch all agents associated with the current user or organization. Use after validating your Phantombuster API key to list available agents.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_AGENTS_FETCH_DELETEDTool to get deleted agents for the current user or organization. Use when you need to audit recently removed agents.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_BRANCHES_DIFFTool to get the length difference between the staging and release branch of all scripts. Use when assessing branch changes before deployment.
Input parameters
Name of the script branch to fetch the diff from.
ID of the org performing the operation. Not required when using a personal API key.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_BRANCHES_FETCH_ALLTool to fetch all branches associated with the current organization. Use when you need to enumerate every branch across your scripts.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_CONTAINERS_FETCH_ALLTool to get all containers associated with a specified agent. Use when you need to retrieve every container for a given agent, for monitoring or reporting.
Input parameters
ID of the agent whose containers will be fetched.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_LEADS_BY_LISTTool to fetch leads by their list ID. Use when you need to retrieve leads from a specific list with optional pagination and filtering.
Input parameters
Id of the lead list to fetch leads from.
Option for retrieving the company associated to the lead.
Options for paginating through leads.
ID of the org that is performing the operation (not necessary when using a third party key).
Array of lead object types (max 3 items).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_LOCATION_IPTool to retrieve the country of a given or environment IP address. Use when you need to geolocate an IP endpoint. Example: get_location_ip(ip="8.8.8.8")
Input parameters
IPv4 or IPv6 address to retrieve the country of. Omit to use the current environment's public IP.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_ORGS_EXPORT_AGENT_USAGETool to export agent usage CSV for current organization. Use when you need a downloadable report of all agents' run statistics in CSV format.
Input parameters
Number of days of data to export (1 to 180).
If set, export data only for this agent ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_ORGS_EXPORT_CONTAINER_USAGETool to export container usage CSV for current organization. Use when you need a downloadable CSV report of container execution history up to 6 months; URL expires in 30 days.
Input parameters
Number of days of data to export (1 to 180).
If set, export data only for this agent ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_ORGS_FETCHTool to fetch current organization details. Use when you need to retrieve the organization associated with the provided API key.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_ORGS_FETCH_AGENT_GROUPSTool to get agent groups and order for the current organization. Use when you need to review how agents are grouped and ordered.
Input parameters
ID of the org performing the operation (omit if using your own API key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_ORGS_FETCH_RESOURCESTool to get current organization's resources and usage. Use when you need to monitor quotas.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_ORGS_FETCH_RUNNING_CONTAINERSTool to get the current organization's running containers. Use after listing agents to identify active containers across the organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_ORG_STORAGE_LISTS_FETCH_ALLTool to fetch all storage lists for the authenticated organization. Use when you need to enumerate every storage list available (Beta).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_SCRIPTTool to fetch a script by its unique ID. Use when you need to retrieve detailed metadata about a specific script, including its branches, visibility, and optionally its source code.
Input parameters
Id of the script to fetch.
If set, the specified branch will be used to retrieve the script.
Environment enumeration for withCode parameter.
Environment enumeration for script branches.
ID of the org that is performing the operation. Not necessary when using a third party key.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_SCRIPT_BY_NAMETool to retrieve a script by its name from Phantombuster (Legacy v1 API). Use when you need to fetch script metadata or content by name. Supports both JSON (structured) and raw (plain text) response formats.
Input parameters
Response format: 'json' returns structured metadata.
Name of the script to retrieve, with its extension (.js or .coffee).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_SCRIPTS_CODETool to get the code of a script. Use when you need to retrieve the source code content of a specific script.
Input parameters
If set, the specified org will be used to fetch the code.
If set, the specified branch will be used to fetch the code.
Name of the script to fetch the code from.
Environment enum for script code fetching.
ID of the org that is performing the operation (not necessary when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_SCRIPTS_FETCH_ALLTool to fetch all scripts for the current user. Use after authenticating your Phantombuster API key to list scripts without their code bodies.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_GET_USERTool to get information about your PhantomBuster account and your agents using the legacy v1 API. Use when you need to check account quotas, remaining resources, or list associated agents.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_POST_AGENTS_UNSCHEDULE_ALLTool to unschedule all scheduled launches for agents. Use when you need to disable every automated agent run organization-wide after verifying your API key.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_POST_AI_COMPLETIONSTool to request a text completion from the AI module. Use when you need to generate text based on a prompt.
Input parameters
Number of completion choices to generate.
Sequences where the API will stop generating further tokens.
Nucleus sampling probability between 0 and 1.
Identifier of the AI model to use for the completion.
Input text prompt to generate a completion for.
Maximum number of tokens to generate in the completion.
Sampling temperature between 0 and 1.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_POST_BRANCHES_CREATETool to create a new branch. Use when you need to isolate updates by creating a separate branch. Use after authenticating with your Phantombuster API key and optionally specifying an organization.
Input parameters
Name of the branch to create.
ID of the organization performing the operation (not needed when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_POST_BRANCHES_DELETETool to delete a branch by id. Use when you need to remove obsolete or incorrect script branches; ensure the branch exists before calling.
Input parameters
The unique identifier of the branch to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_POST_HCAPTCHATool to solve an hCaptcha challenge. Use when you need a valid hCaptcha token for form submissions or automation flows.
Input parameters
Proxy URL (e.g., http://user:pass@host:port) to route requests through.
Full URL of the page where the hCaptcha appears.
The public site key of the hCaptcha widget.
Custom User-Agent to simulate in the solving request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_POST_IDENTITIES_GENERATE_TOKENTool to generate an identity token for PhantomBuster. Use when you need to create a new identity token for authentication or session management.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_POST_ORG_STORAGE_LEADS_SAVE_MANYTool to save multiple leads (1-20) to organization storage in a single batch operation (Beta). Use when you need to create or update leads with LinkedIn profile data and optional enrichment fields.
Input parameters
Array of leads to save. Must contain between 1 and 20 leads. Each lead requires a linkedinProfileUrl.
ID of the organization performing the operation (not necessary when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_POST_RECAPTCHATool to solve a reCAPTCHA challenge (v2 or v3). Use when you need a valid reCAPTCHA response token for form submissions or automation. Note: API returns 200 status even on errors; check the error field in the response.
Input parameters
The site key of the reCAPTCHA widget (found in the page HTML or network requests).
Full URL of the page where the reCAPTCHA widget appears.
Version of reCAPTCHA to solve: 'v2' for checkbox or invisible reCAPTCHA, 'v3' for score-based reCAPTCHA.
Minimum score required for reCAPTCHA v3 (between 0 and 1). Only applicable for type='v3'.
Action name for reCAPTCHA v3 (matches the action parameter in grecaptcha.execute). Only applicable for type='v3'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_POST_SCRIPTS_VISIBILITYTool to update the visibility of a script. Use when you need to change whether a script is private, public, or open source.
Input parameters
Name of the script to change visibility for.
Name of the branch to change visibility for.
New branch visibility.
ID of the organization performing the operation (not needed when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_RELEASE_BRANCHTool to release a script branch. Use when you need to deploy a branch to production or release changes to specified scripts.
Input parameters
Name of the branch to release.
List of script IDs to release.
ID of the organization performing the operation (not needed when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_AGENTTool to create a new agent or update an existing one. Use when you need to configure an agent's launch schedule, settings, or behavior. If an agent ID is provided, the existing agent will be updated; otherwise, a new agent is created.
Input parameters
If provided, updates the existing agent with this ID. If omitted, creates a new agent.
Organization to link the agent to (pattern: ^(deleted_\\d{1,16}-)?\[a-z\]\[a-z0-9-_\]{1,48}\[a-z0-9_\]$).
Name of the agent (max 100 characters)
Branch to assign the agent to (alphanumeric, dash, max 50)
Script filename to assign to the agent (e.g., 'myscript.js')
Default argument used to launch the agent (string or object)
Unix timestamp (epoch ms) when the agent will be deleted.
Agent file management type.
Proxy type configuration.
Launch type for the agent.
Sets the agent's object as a JSON string.
Script branch environment.
Must be set when launchType is 'once'. Unix timestamp (epoch ms) for single launch.
HTTP proxy address (for proxyType='http') or proxy pool name (for proxyType='pool').
Notification settings for the agent.
Password for proxy authentication (used with proxyType='http').
Username for proxy authentication (used with proxyType='http').
Optional key for idempotent operations - only for creating an agent.
Maximum number of concurrent executions of the agent.
Maximum number of retries the agent will attempt before aborting.
Execution time limit in seconds. Agent will be stopped if this limit is exceeded.
Maximum number of folders for file management.
Must be set when launchType is 'after agent'. ID of the agent that triggers this agent.
Schedule configuration for repeated launches.
Preset launch schedules.
Squid lease configuration.
Delay in seconds before launching after a slave agent finishes. Platform defaults to 10-15 minutes if not set.
Launch if slave agent's exit code matches array values, or set to 'all' to launch on any exit code.
If true, applies the manifest's default settings to the agent.
If true, the agent's setup is considered complete.
If true, propagates updated settings to workers regardless of session type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_AGENT_GROUPSTool to update agent groups and order for the current user's organization. Use when you need to reorganize agents into groups or change their display order.
Input parameters
New agent groups. Can be a list of agent IDs (strings) or AgentGroup objects with id, name, and agents. Order of the groups and agents will be preserved.
ID of the org performing the operation (not necessary when using a third party key)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_COMPANY_OBJECTTool to save one company object to the organization storage. Use when you need to create or update a company object with LinkedIn company data and custom properties.
Input parameters
The internal id of the company object. If provided, updates the existing object.
The slug of the company object.
The type of company object.
The org id associated with the company object.
The properties of the object. Can contain any additional company data.
The external id of the company scraped from LinkedIn.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_COMPANY_OBJECTS_MANYTool to save many company objects to organization storage. Use when you need to bulk insert or update company data with a minimum of 1 and maximum of 20 objects per request.
Input parameters
List of company objects to save. Minimum 1, maximum 20 objects.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_IDENTITY_EVENTTool to save an identity event to Phantombuster. Use when you need to record user interactions or activities associated with specific social media profiles.
Input parameters
Optional timestamp of the identity event in milliseconds since epoch. Must be between 1000000000000 and 9999999999999.
Event data of the identity event containing additional information about the event.
Type of the identity event (e.g., profile_view, connection_request).
Profile ID of the identity event.
Identity type of the identity event (e.g., linkedin, twitter, facebook).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_LEADTool to save or update a lead in Phantombuster org storage. Use when you need to store LinkedIn profile data or other lead information.
Input parameters
Error message if there was an issue processing the lead.
Civility or title of the lead (e.g., Mr., Ms., Dr.).
Last name of the lead.
Geographic location of the lead.
Additional metadata for the lead.
List of websites associated with the lead.
First name of the lead.
Current company name of the lead.
List of phone numbers of the lead.
Website of the lead's current company.
List of personal email addresses of the lead.
Audience segments this lead belongs to.
Industry of the lead's current company.
LinkedIn headline of the lead.
Current job title of the lead on LinkedIn.
LinkedIn company ID of the lead's current company.
LinkedIn profile ID of the lead.
Twitter profile URL of the lead.
LinkedIn company URL.
LinkedIn profile URL of the lead (required). This is the unique identifier for the lead.
URN of the lead's LinkedIn profile.
Name of the lead's school on LinkedIn.
List of professional email addresses of the lead.
ID of the org that is performing the operation (not necessary when using a third party key).
LinkedIn company slug.
LinkedIn description or summary of the lead.
Location of the lead's current job on LinkedIn.
Whether the lead has an open LinkedIn profile.
Skills label from the lead's LinkedIn profile.
Name of the lead's previous company.
Date range of the lead's current job on LinkedIn.
Degree obtained at the lead's school on LinkedIn.
AI-generated properties for the lead.
Custom results file name for the lead.
Whether the lead has a hiring badge on LinkedIn.
Number of LinkedIn followers the lead has.
Description of the lead's current job on LinkedIn.
URL of the lead's LinkedIn profile image.
URN of the lead's LinkedIn profile image.
Date range of the lead's school attendance on LinkedIn.
Previous job title of the lead on LinkedIn.
LinkedIn URL of the lead's school.
Sales Navigator profile URL of the lead.
Whether the lead has an open to work badge on LinkedIn.
Description of the lead's school on LinkedIn.
LinkedIn URL of the lead's previous company.
Name of the lead's previous school on LinkedIn.
Location of the lead's previous job on LinkedIn.
CRM account relative properties for the lead.
Date range of the lead's previous job on LinkedIn.
Degree obtained at the lead's previous school on LinkedIn.
Description of the lead's previous job on LinkedIn.
Date range of the lead's previous school attendance on LinkedIn.
LinkedIn URL of the lead's previous school.
LinkedIn account relative properties for the lead.
Description of the lead's previous school on LinkedIn.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_LEAD_OBJECTTool to save a lead object to organization storage. Use when you need to store or update lead information with custom properties.
Input parameters
Slug of the object to save. Must be 470 characters or less.
Type of object to save.
ID of a lead to associate with this object.
ID of the agent associated with this lead object.
URN of a lead to associate with this object.
Slug of a lead to associate with this object.
Properties of the object. Can contain any key-value pairs.
ID of a lead object to update. If provided, updates existing object instead of creating new one.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_LEADS_OBJECTS_MANYTool to save multiple lead objects to Phantombuster's organization storage. Use when you need to create or update multiple lead objects in a single API call.
Input parameters
Array of lead objects to save. Each object must include type, slug, properties, and agentId.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_LISTTool to save (create or update) a list with filter criteria. Use when you need to create a new list or update an existing one by providing a filter configuration. This is a Beta feature.
Input parameters
A string for updating existing lists (omit when creating new ones).
A string specifying the list's title.
An array of strings for organizational categorization. Allowed values: 'hidden', 'workflow', 'pbai', 'opinion-leaders'
An object that configures which leads are included in the list. Supports global search using '__global_search__' key, simple field filters, logical AND/OR operators, and complex nested filters. Example: {'__global_search__': 'test'} or {'email': 'user@example.com'}
A string describing the list's purpose.
ID of the org that is performing the operation (not necessary when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SAVE_SCRIPTTool to create a new script or update an existing one. Provide an id to update; otherwise creates new script. Use when you need to save JavaScript automation code to Phantombuster.
Input parameters
If provided, the script with this ID will be updated. Otherwise, a new script is created.
JavaScript source code of the script (max 600,000 chars).
Name of the script file. Must end with .js or .coffee. Prepend with 'lib-' to define as a module.
Name of the branch to associate with the script (alphanumeric, hyphens, 1-50 chars).
JSON script manifest required to create/update a script.
Markdown description of the script (max 200,000 chars).
ID of the organization performing the operation (not needed when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SEARCH_COMPANY_OBJECTSTool to search company objects in Phantombuster's organizational storage. Use when you need to find companies by specific criteria or perform a global search.
Input parameters
Array of filter conditions joined by OR logic. Each condition is an object with field names as keys and string values.
Array of filter conditions joined by AND logic. Each condition is an object with field names as keys and string values.
Nested filter object for more complex filtering logic with field names as keys and string values.
Global search string to search across all fields of company objects.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_SEARCH_LEAD_OBJECTSTool to search lead objects in Phantombuster org storage. Use when you need to find leads based on search criteria or filter conditions.
Input parameters
Filter criteria for searching leads. Use '__global_search__' for simple text searches across all fields.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_STOP_AGENTTool to stop a running agent. Use when you need to halt agent execution, optionally cascading to slave agents or switching to manual launch mode.
Input parameters
Id of the agent to stop.
If true, tries to softly abort the agent.
If true, disables the next scheduled 'launch soon' of the agent.
If true, slave agents will recursively be stopped (even nested slaves).
If true, the agent will switch to manual launch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_UPDATE_SCRIPTTool to update an existing script or create a new one if it does not exist (Legacy v1 API). Use when you need to save script code to Phantombuster. If insertOnly is true, the operation will fail if a script with the same name already exists.
Input parameters
Name of the script to update or create, with its extension (.js or .coffee).
Full text contents of the script.
If true, make sure that we don't update an existing script. An error will be returned if a script with the same name already exists.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PHANTOMBUSTER_UPDATE_SCRIPTS_ACCESS_LISTTool to update the access list of a script. Use when you need to add or remove users/orgs from a script's access list in a specific branch.
Input parameters
Org or user to add in the access list.
Name of the script to update the access list of.
Name of the branch to update the access list of.
Org or user to remove from the access list.
ID of the org that is performing the operation (not necessary when using a third party key).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 72 agents privately built on Nagent that already use PhantomBuster.
Build on Nagent
Connect PhantomBuster to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find PhantomBuster, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, PhantomBuster is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once PhantomBuster is connected, you configure its 53 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop PhantomBuster steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a PhantomBuster event fires, the agent kicks off automatically.
Every PhantomBuster action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While PhantomBuster ships with 53 pre-built ai web scraping actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching PhantomBuster together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build PhantomBuster-based workflows tailored to your business.