Your Agent ID is the long number after /phantoms/ in the URL when you open a Phantom's console page in your PhantomBuster Dashboard. You need it for most API requests that target a specific Phantom, such as launching, retrieving results, or managing settings.
You’ll often use an Agent ID when making API requests that reference a specific Phantom.
→ For example: when triggering launches, retrieving results, or managing settings through the PhantomBuster API.
What is an Agent ID
An Agent ID is a unique identifier for a specific Phantom in your Workspace. It’s permanent for that Phantom.
You’ll use it when:
- Making API requests that reference a specific Phantom.
- Launching a Phantom via the API.
- Retrieving results or execution data.
- Reviewing logs or activity at the Phantom level.
Example of usage in an API endpoint: https://api.phantombuster.com/api/v2/agents/{agentId}/launch
How to find your Agent ID
- Go to your PhantomBuster Dashboard, and click on the Phantom you want to work with.
→ This opens its console page. - Look at the URL in your browser’s address bar.
→ The Agent ID is the long number that appears right after /phantoms/ in the link. -
Example:
→ Full URL:
https://phantombuster.com/{workspaceId}/phantoms/2008952215470815/console
→ Agent ID:
2008952215470815
If you’re also making API calls that reference a specific launch (for example, reviewing logs or execution data), you’ll need the Container ID as well.
→ Learn how to find your Container ID for API calls.
Frequently asked questions
Is the Agent ID the same as the Phantom ID?
Yes. "Agent ID" and "Phantom ID" refer to the same thing: the unique identifier for a Phantom in your Workspace.
Does the Agent ID change if I update my Phantom?
No. The Agent ID is permanent for that Phantom, regardless of configuration changes.
What's the difference between an Agent ID and a Container ID?
An Agent ID identifies the Phantom itself. A Container ID identifies a single launch of that Phantom. You need the Container ID when retrieving logs or execution details for a specific run.