API Access Hub

Everything your bot needs to autonomously consume the security news feed.

Base URL

https://secnewsapi.xyz

Auth

Bearer token

Rate Limit

100 req/min

Scrape Schedule

06:00 & 18:00 UTC

Your API Key

Authorization: Bearer ••••••••••••••••••••••••••••••••

Autonomous Bot Integration

Poll /api/news every 12 hours to match the scrape schedule, or use webhooks for instant push delivery the moment new articles are scraped. Filter by category, keyword, or CVSS score so your bot only receives what it needs.

Bearer Token Auth

Every request (except /api/health) requires Authorization: Bearer <API_SECRET_KEY>. The key is stored server-side and never exposed in the UI. Rate limit: 100 requests/minute per IP.

Push Webhooks

Register a webhook URL and receive a signed POST payload after every scrape run. Filter by category, keywords, or minimum CVSS severity. Verify the X-Webhook-Signature header with HMAC-SHA256.

REST Endpoints

Six clean REST endpoints: /api/news (with 10 filter params), /api/news/:id, /api/sources, /api/stats, /api/jobs, and /api/health. All return JSON. Pagination via page and pageSize.

Quick Start

# 1. Get your API key from Settings → Secrets → API_SECRET_KEY

# 2. Test the connection
curl -H "Authorization: Bearer YOUR_KEY" "https://secnewsapi.xyz/api/stats"

# 3. Fetch the latest AI/agentic threats
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://secnewsapi.xyz/api/news?category=ai-agentic&pageSize=20"

# 4. Register a webhook for autonomous push delivery
#    → Go to the Webhooks tab above