REST API Microservice & Docker Deployment

Deploy Playtrafi as a standalone microservice for non-Python applications (Node.js, Go, Rust, Ruby, C#).

---

🚀 Launching the Microservice

Via CLI

playtrafi serve --host 0.0.0.0 --port 4013

Via Docker

docker run -d -p 4013:4013 --name playtrafi marcuszou/playtrafi:latest

Via Docker Compose

version: "3.8"

services:
  playtrafi:
    image: marcuszou/playtrafi:latest
    container_name: playtrafi-api
    restart: unless-stopped
    ports:
      - "4013:4013"
    environment:
      - PYTHONUNBUFFERED=1
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:4013/health"]
      interval: 30s
      timeout: 5s
      retries: 3

---

📡 API Endpoints

1. Health Check (GET /health)

curl http://localhost:4013/health

Response:

{
  "status": "healthy",
  "version": "0.5.2",
  "engine": "patchright",
  "active": true
}

2. Scrape Single URL (POST /scrape)

curl -X POST http://localhost:4013/scrape \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://news.ycombinator.com",
    "screenshot": true,
    "wait_for": ".athing"
  }'

3. Batch Scrape (POST /scrape/batch)

curl -X POST http://localhost:4013/scrape/batch \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://site1.com",
      "https://site2.com"
    ],
    "concurrency": 4
  }'