AyeWatch API

Monitor Internet Information and receive real-time webhook events via the AyeWatch REST API.

Base URLhttps://ayewatch.ai/api/v1

What is the AyeWatch API?

The AyeWatch API lets you programmatically manage monitoring internet information topics and receive real-time notifications when content changes are detected. Instead of manually checking for updates, you define topics to monitor and AyeWatch delivers structured webhook events to your application whenever something new happens.

Create, list, update, and delete monitoring topics via REST
Set your webhook endpoint and rotate its signing secret via REST
Receive topic.update webhook events with AI-generated summaries
Verify webhook signatures with HMAC-SHA256
Authenticate all requests with a Bearer API key

Quick Start

Get started in two steps: create a topic to monitor, then set up a webhook to receive updates.

Step 1, Create a topic (monitors a URL)

Request

shell

curl -X POST https://ayewatch.ai/api/v1/topics \
  -H "Authorization: Bearer aw_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "https://openai.com/news",
    "interval": "1_hour"
  }'

Response, 201 Created

json

{
  "data": {
    "id": 1042,
    "name": "https://openai.com/news",
    "description": null,
    "is_active": true,
    "interval": "1_hour",
    "created_at": "2026-08-03T12:00:00Z"
  }
}

Step 2, Configure your webhook endpoint

Set your webhook URL with the API, or in the Notification settings. AyeWatch will POST an event to your endpoint whenever a monitor finds something new.

Request

shell

curl -X PUT https://ayewatch.ai/api/v1/webhook \
  -H "Authorization: Bearer aw_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url": "https://example.com/hooks/ayewatch"}'

The response includes the secret you use to verify each delivery's signature.

Example webhook payload

json

{
  "topic_id": 1042,
  "topic_name": "https://openai.com/news",
  "headline": "GPT-5 announced",
  "content": "OpenAI today announced GPT-5...",
  "created_at": "2026-03-08T13:00:00Z"
}

Explore the Docs

Authentication

auth

API key format, Bearer headers, and security tips.

Topics API

REST

Create, list, update, and delete monitoring topics.

Webhooks

events

Webhook API, event format, HMAC signature verification, and retry behavior.

Errors

ref

HTTP status codes and standard error response shape.

Markdown for LLMs and Agents

Every page in these docs is also served as plain Markdown. Use Copy page at the top of any page, append .md to its URL, or request the page with an Accept: text/markdown header.

/documentation/topics.md , any single page, as Markdown.
/documentation/all.md , the entire API reference in one file.
/llms.txt and /llms-full.txt , site-wide summaries for retrieval.

Fetch this page as Markdown

shell

curl https://ayewatch.ai/documentation/topics.md

# or negotiate on the HTML URL
curl -H "Accept: text/markdown" https://ayewatch.ai/documentation/topics