API — Port Pool

Open and manage port pools — batches of ports opened from a proxy list for large, concurrent jobs — then export the results.

Open a pool

NoteThe Port Pool endpoints live under the /scraper path for backward compatibility — it is the same feature as the + Port Pool button in the dashboard.

POST /api/v1/scraper/tasks Auth required

Opens a port pool from a proxy list.

Example (curl)

curl -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"tiktok-pool","count":100}' \
  http://127.0.0.1:8891/api/v1/scraper/tasks

List & stop pools

GET /api/v1/scraper/tasks Auth required

Lists all port pools and their progress.

DELETE /api/v1/scraper/tasks/{id} Auth required

Stops a pool and closes its ports.

POST /api/v1/scraper/tasks/{id}/test Auth required

Tests the pool's proxy list.

Export results

GET /export/{token}/proxies.txt No auth

Downloads a pool's ports as a plain-text proxy list. Access is granted by the token in the URL, so no API key is needed.

Example (curl)

curl http://127.0.0.1:8891/export/TASK_TOKEN/proxies.txt