Monitor a Company (webhooks)

Create a watch on any company by URL and get alerts when it changes — funding, jobs, tech stack, headcount, news, status, pricing, new domains. Pass a webhook_url for near-real-time delivery: the moment a change is detected we POST a structured event to your endpoint. GET /monitor lists your watches (free); DELETE /monitor?id=… cancels one (free). Plan tier governs how many companies you can watch, the cadence, and which signals.

POSThttps://www.startuphub.ai/api/v1/monitor

Request

curl -X POST "https://www.startuphub.ai/api/v1/monitor" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"cursor.com","signals":["funding","jobs","pricing"],"webhook_url":"https://yourapp.com/hooks/monitor"}'

Parameters

urlstringrequired

Company website or domain to watch (e.g. acme.com). Works on stealth startups not yet in the directory.

signalsstring[]optional

funding, jobs, tech, headcount, news, status, pricing, domains. Defaults to everything your plan allows.

frequencystringoptional

Cadence: weekly | daily | 12h | 4h. Clamped to your plan max (faster = higher tier).

webhook_urlstringoptional

HTTPS endpoint. We POST {event, entity_id, title, body, metadata, delivered_at} the moment a change is detected.

delivery_channelsstring[]optional

email | slack | teams. Defaults to email. webhook_url is independent and always fires when set.

Response

json

{
  "data": {
    "id": "a1b2c3d4-...",
    "domain": "cursor.com",
    "entity_name": "Cursor",
    "frequency": "daily",
    "signals": ["funding", "jobs", "pricing"],
    "delivery_channels": ["email"],
    "webhook_url": "https://yourapp.com/hooks/monitor",
    "next_poll_at": "2026-05-25T20:30:00Z"
  },
  "credits": { "cost": 5, "remaining_period": 49995, "remaining_balance": 0 }
}

// Webhook payload — POSTed to webhook_url the moment a change is detected:
{
  "event": "funding",
  "entity_id": "...",
  "title": "Cursor raised a Series C",
  "body": "Led by ... · $...",
  "metadata": { "signal": "funding" },
  "delivered_at": "2026-05-25T21:14:00Z"
}

Errors

402Plan watch limit reached — upgrade to track more companies

409You are already watching this domain

PreviousAI-Generated Startup Lists