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
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",
    "topic_type": "web_page",
    "is_active": true,
    "interval": "1_hour",
    "schedule_arn": "arn:aws:scheduler:...:schedule/default/topic-1042",
    "next_run_at": null,
    "created_at": "2026-08-03T12:00:00Z",
    "schedule_status": "synced"
  }
}

Step 2 — Configure your webhook endpoint

Set your webhook URL in the Developer dashboard. AyeWatch will POST events to your endpoint whenever a topic is checked.

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

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