API included on every paid plan

Automate everything with the Bulldog API

A clean REST API plus native Selenium, Puppeteer and Playwright support. No enterprise gate — Pro at $34/mo gets the full API.

REST API

Create profiles, attach proxies, start sessions and manage your team — all over HTTPS with bearer-token auth.

# Create a profile
curl -X POST https://api.bulldogbrowser.com/v1/profiles \
  -H "Authorization: Bearer $BULLDOG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "us-store-01",
    "os": "windows",
    "proxy": { "type": "socks5", "host": "1.2.3.4", "port": 1080 }
  }'

# Start it and get the DevTools endpoint
curl -X POST https://api.bulldogbrowser.com/v1/profiles/prof_8f2k/start \
  -H "Authorization: Bearer $BULLDOG_API_KEY"
# => { "wsEndpoint": "ws://127.0.0.1:35001/devtools/browser/..." }

Core endpoints

POST/v1/profilesCreate a profile (fingerprint auto-generated)
GET/v1/profilesList profiles with filters and pagination
POST/v1/profiles/:id/startLaunch a profile, get CDP endpoint
POST/v1/profiles/:id/stopStop a running profile, sync to cloud
PATCH/v1/profiles/:id/proxySwap proxy without touching fingerprint
POST/v1/profiles/:id/cookiesImport cookies (JSON / Netscape)
POST/v1/profiles/:id/restoreRestore a deleted profile
POST/v1/team/shareShare profiles with team members

Puppeteer, Playwright & Selenium

Every running profile exposes a standard Chrome DevTools endpoint. Connect your existing scripts with one line — the fingerprint, proxy and cookies are already handled.

import puppeteer from "puppeteer-core";
import { Bulldog } from "@bulldogbrowser/sdk";

const bulldog = new Bulldog(process.env.BULLDOG_API_KEY);
const { wsEndpoint } = await bulldog.profiles.start("prof_8f2k");

const browser = await puppeteer.connect({
  browserWSEndpoint: wsEndpoint,
});

const page = await browser.newPage();
await page.goto("https://www.example-marketplace.com");
// ...your automation, running inside a clean fingerprint
await browser.disconnect();
await bulldog.profiles.stop("prof_8f2k");

Webhooks

Get notified the moment a profile starts, stops, fails its proxy check or gets shared. Signed payloads, automatic retries with exponential backoff.

POST https://your-server.com/webhooks/bulldog
Content-Type: application/json
X-Bulldog-Signature: sha256=ab83f1...

{
  "event": "profile.started",
  "timestamp": "2026-06-12T14:03:22Z",
  "data": {
    "profile_id": "prof_8f2k",
    "name": "us-store-01",
    "started_by": "user_a91x",
    "proxy_geo": "US-NY"
  }
}

// Events: profile.created, profile.started, profile.stopped,
// profile.deleted, profile.restored, proxy.failed,
// team.member_added, team.profile_shared

Ship your automation this week

Full API access starts at $34/mo on Pro — not $99/mo behind an enterprise gate.

Download FreeSee Pricing

7-day free trial · No credit card required · Cancel anytime