Scheduler

curl -X POST https://api.alterlab.io/api/v1/schedules \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily product prices",
    "urls": [
      "https://store.example.com/product-1",
      "https://store.example.com/product-2"
    ],
    "cron": "0 9 * * *",
    "timezone": "America/New_York",
    "formats": ["json", "markdown"],
    "options": {
      "wait_for": ".price-tag",
      "timeout": 30
    },
    "webhook_url": "https://your-server.com/schedule-webhook"
  }'

curl -X POST https://api.alterlab.io/api/v1/crawl/schedules \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekly docs crawl",
    "url": "https://docs.example.com",
    "cron": "0 2 * * 0",
    "timezone": "UTC",
    "options": {
      "max_pages": 500,
      "max_depth": 5,
      "formats": ["markdown"]
    },
    "webhook_url": "https://your-server.com/crawl-results"
  }'

curl -X POST https://api.alterlab.io/api/v1/map/schedules \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily sitemap refresh",
    "url": "https://example.com",
    "cron": "0 1 * * *",
    "timezone": "UTC",
    "options": {
      "include_subdomains": false,
      "limit": 10000
    },
    "webhook_url": "https://your-server.com/map-results"
  }'

curl https://api.alterlab.io/api/v1/schedules?active_only=true \
  -H "Authorization: Bearer your_jwt_token"

curl -X PATCH https://api.alterlab.io/api/v1/schedules/{schedule_id} \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{ "cron": "0 */2 * * *", "name": "Every 2 hours" }'

# Pause
curl -X POST https://api.alterlab.io/api/v1/schedules/{schedule_id}/pause \
  -H "Authorization: Bearer your_jwt_token"

# Resume (recomputes next_run_at, re-checks balance limits)
curl -X POST https://api.alterlab.io/api/v1/schedules/{schedule_id}/resume \
  -H "Authorization: Bearer your_jwt_token"

{
  "runs": [
    {
      "id": "run-uuid-...",
      "schedule_id": "schedule-uuid-...",
      "status": "completed",
      "job_ids": ["job-1-...", "job-2-..."],
      "batch_id": "batch-...",
      "urls_total": 2,
      "urls_completed": 2,
      "urls_failed": 0,
      "credits_used": 30000,
      "started_at": "2026-03-03T09:00:01Z",
      "completed_at": "2026-03-03T09:00:14Z",
      "created_at": "2026-03-03T09:00:00Z"
    }
  ],
  "total": 42
}

import requests

API_URL = "https://api.alterlab.io/api/v1"
HEADERS = {
    "Authorization": "Bearer your_jwt_token",
    "Content-Type": "application/json",
}

# Create a schedule
schedule = requests.post(
    f"{API_URL}/schedules",
    headers=HEADERS,
    json={
        "name": "Competitor prices - daily",
        "urls": [
            "https://competitor-a.com/product",
            "https://competitor-b.com/product",
        ],
        "cron": "0 9 * * *",
        "timezone": "America/New_York",
        "formats": ["json"],
        "webhook_url": "https://your-server.com/prices",
    },
).json()

print(f"Schedule created: {schedule['id']}")
print(f"Next run: {schedule['next_run_at']}")

# List active schedules
schedules = requests.get(
    f"{API_URL}/schedules?active_only=true",
    headers=HEADERS,
).json()

for s in schedules["schedules"]:
    print(f"  {s['name']} — next: {s['next_run_at']}, runs: {s['run_count']}")

# Check execution history
runs = requests.get(
    f"{API_URL}/schedules/{schedule['id']}/runs",
    headers=HEADERS,
).json()

for run in runs["runs"]:
    print(f"  Run {run['id']}: {run['status']} — {run['urls_completed']}/{run['urls_total']}")

const API_URL = "https://api.alterlab.io/api/v1";
const headers = {
  Authorization: "Bearer your_jwt_token",
  "Content-Type": "application/json",
};

// Create a schedule
const schedule = await fetch(`${API_URL}/schedules`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    name: "Competitor prices - daily",
    urls: [
      "https://competitor-a.com/product",
      "https://competitor-b.com/product",
    ],
    cron: "0 9 * * *",
    timezone: "America/New_York",
    formats: ["json"],
    webhook_url: "https://your-server.com/prices",
  }),
}).then((r) => r.json());

console.log(`Schedule: ${schedule.id}, next run: ${schedule.next_run_at}`);

// List active schedules
const list = await fetch(`${API_URL}/schedules?active_only=true`, {
  headers,
}).then((r) => r.json());

for (const s of list.schedules) {
  console.log(`  ${s.name} — runs: ${s.run_count}`);
}

// Check runs
const runs = await fetch(`${API_URL}/schedules/${schedule.id}/runs`, {
  headers,
}).then((r) => r.json());

for (const run of runs.runs) {
  console.log(`  ${run.status}: ${run.urls_completed}/${run.urls_total}`);
}