Watchlist

Add a company to the watchlist with a recurring schedule.

Request body

Copy{
  "company_url": "https://example.com",
  "company_name": "Example Inc",
  "schedule": "biweekly"
}

Response

Copy{
  "object": "watchlist_item",
  "id": 1,
  "company_url": "https://example.com",
  "company_name": "Example Inc",
  "schedule": "biweekly",
  "status": "active"
}

List all watched companies. Supports cursor pagination.

Response

Copy{
  "object": "list",
  "data": [
    {
      "object": "watchlist_item",
      "id": 1,
      "company_url": "https://example.com",
      "company_name": "Example Inc",
      "schedule": "biweekly",
      "status": "active",
      "latest_composite_score": 78,
      "latest_pain_score": 85
    }
  ],
  "has_more": false
}

Update schedule or pause/resume a watchlist item.

Request body

Copy{ "schedule": "weekly" }
// or
{ "status": "paused" }

Response

Copy{
  "object": "watchlist_item",
  "id": 1,
  "company_url": "https://example.com",
  "schedule": "weekly",
  "status": "active"
}

Get score change history for a watched company.

Response

Copy{
  "object": "watchlist_history",
  "history": [
    {
      "date": "2026-02-16",
      "composite_score": 78,
      "pain_score": 85,
      "fit_score": 72,
      "timing_score": 80
    },
    {
      "date": "2026-02-01",
      "composite_score": 65,
      "pain_score": 70,
      "fit_score": 68,
      "timing_score": 55
    }
  ]
}