Phantombuster

​

How to set up Phantombuster

​

Authentication

Phantombuster uses API key authentication:

1. Sign up at phantombuster.com
2. Open your Workspace settings
3. Copy your API key
4. Paste the API key in Cargo when connecting

Cargo spreads requests at up to 100 calls per minute against the Phantombuster API.

​

Phantombuster actions

​

Launch Agent

Launch a Phantombuster agent, wait for the run to finish, and return its result items. Required fields:

• Agent: Select the agent to launch

Optional fields:

• Argument: JSON argument to pass to the agent

Use case: Trigger a Phantombuster scraping or automation agent from a workflow and use its output downstream.

​

Data models

Phantombuster also provides a Fetch Agent Results extractor, so you can sync agent output into Cargo as records without launching the agent yourself:

• Pick the agent to fetch results from
• Cargo fetches the result object of each finished agent run and turns items into records (columns are inferred from the items, deduplicated by a content hash)
• Syncs are incremental — only runs that ended after the last sync are fetched, at most every 30 minutes

Use case: Keep a Cargo model up to date with the leads a scheduled Phantombuster agent produces.

​

Best practices

• Validate the Argument field is valid JSON — the action fails otherwise
• Use the extractor (rather than the action) when the agent runs on its own schedule in Phantombuster
• Agent runs that error, crash, or time out fail the action with the agent’s exit message