Agentic News Agents API
Create and manage monitoring agents (watches). Each agent tracks a topic and automatically finds matching stories. Requires auth.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/agentic-news-ai:agentic-news-ai-agents-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Agentic News Ai Agents API
version: 1.0.0
contact:
name: Agentic News
url: https://agentic-news.ai
description: 'Operations tagged Agents across 2 of this provider''s published API definitions: openapi.json, agentic-news-ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.agentic-news.ai
description: Production
tags:
- name: Agents
description: Create and manage monitoring agents (watches). Each agent tracks a topic and automatically finds matching stories. Requires auth.
paths:
/watches:
get:
operationId: listAgents
summary: List monitoring agents
tags:
- Agents
description: List all monitoring agents (watches) for the authenticated user. Each agent continuously monitors a topic and surfaces matching stories in your briefing.
security:
- apiKey: []
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
watches:
type: array
items:
type: object
properties:
id:
type: string
name:
type: string
description:
type: string
kind:
type: string
enum:
- entity
- topic
matchQualityThreshold:
type: integer
description: Minimum match quality (33-100)
requiredTerms:
type: array
items:
type: string
description: Must-include terms
termsUnmatchable:
type: boolean
description: True when the required terms cannot match ANY article — this agent can never surface a story until they change
lensId:
type:
- 'null'
- string
description: Assigned lens ID
lensName:
type:
- 'null'
- string
description: Assigned lens name
paused:
type: boolean
createdAt:
type: string
format: date-time
count:
type: number
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
'500':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
post:
operationId: createAgent
summary: Create monitoring agent
tags:
- Agents
description: Create a new monitoring agent that watches for news about a specific topic or entity. The agent immediately starts matching against existing stories and queues ingestion for fresh content. Be specific in the description for better results.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- description
properties:
name:
type: string
minLength: 1
maxLength: 200
description: Short agent name (e.g., 'AI regulation')
description:
type: string
minLength: 1
maxLength: 1000
description: What the agent should monitor — be specific for better results
kind:
type: string
enum:
- entity
- topic
description: 'Agent type (default: topic)'
requiredTerms:
type: array
items:
type: string
description: Must-include terms — stories must contain at least one of these in title or body. Geographic terms are auto-populated if not provided.
matchQualityThreshold:
type: integer
minimum: 33
maximum: 100
description: Minimum match quality score (33-100, default 45). Higher = fewer but more relevant.
language:
type: string
minLength: 2
maxLength: 5
description: 'ISO 639-1 language code (default: en)'
example:
name: Tesla EV News
description: Electric vehicle industry news about Tesla, Rivian, and competitors
requiredTerms:
- Tesla
- Rivian
- EV
matchQualityThreshold: 50
security:
- apiKey: []
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
watch:
type: object
properties:
id:
type: string
name:
type: string
description:
type: string
kind:
type: string
matchQualityThreshold:
type: integer
requiredTerms:
type: array
items:
type: string
paused:
type: boolean
createdAt:
type: string
format: date-time
'400':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
'500':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
servers:
- url: https://api.agentic-news.ai
description: Production
/watches/{id}:
patch:
operationId: updateAgent
summary: Update monitoring agent
tags:
- Agents
description: Update an agent's name, description, quality threshold, required terms, or lens assignment. Changing name/description retrains what the agent watches for and triggers re-matching.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 200
description: New agent name
description:
type: string
minLength: 1
maxLength: 1000
description: New agent description
lensId:
type:
- string
- 'null'
format: uuid
description: Assign a lens by ID, or null to remove
matchQualityThreshold:
type: integer
minimum: 33
maximum: 100
description: Minimum match quality (33-100, default 45)
requiredTerms:
type: array
items:
type: string
description: Must-include terms. Pass [] to clear.
example:
requiredTerms:
- Tesla
- Rivian
matchQualityThreshold: 55
parameters:
- schema:
type: string
format: uuid
in: path
name: id
required: true
description: Agent ID
security:
- apiKey: []
responses:
'200':
description: Default Response
servers:
- url: https://api.agentic-news.ai
description: Production
/webhooks:
get:
operationId: listWebhooks
summary: List your webhooks
tags:
- Agents
description: Returns all registered webhook endpoints for the authenticated user.
security:
- apiKey: []
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
webhooks:
type: array
items:
type: object
properties:
id:
type: string
url:
type: string
watchId:
type:
- 'null'
- string
events:
type: array
items:
type: string
isActive:
type: boolean
failureCount:
type: integer
lastTriggeredAt:
type:
- 'null'
- string
lastFailureAt:
type:
- 'null'
- string
lastFailureReason:
type:
- 'null'
- string
createdAt:
type: string
post:
operationId: createWebhook
summary: Register a webhook
tags:
- Agents
description: 'Register a URL to receive POST notifications when matches are validated. Optionally scope to a specific agent (watchId). Set `generateSecret: true` to get an HMAC-SHA256 signing secret (returned only once).'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- url
properties:
url:
type: string
format: uri
description: HTTPS URL to receive POST payloads
watchId:
type: string
description: Scope to a specific agent (UUID). Omit for all agents.
events:
type: array
items:
type: string
enum:
- match.validated
default:
- match.validated
generateSecret:
type: boolean
default: false
description: Generate an HMAC-SHA256 signing secret
security:
- apiKey: []
responses:
'201':
description: Default Response
content:
application/json:
schema:
type: object
properties:
id:
type: string
url:
type: string
watchId:
type:
- 'null'
- string
events:
type: array
items:
type: string
secret:
type:
- 'null'
- string
description: HMAC secret (returned only on creation)
createdAt:
type: string
'400':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
servers:
- url: https://api.agentic-news.ai
description: Production
/webhooks/{id}:
patch:
operationId: updateWebhook
summary: Update a webhook
tags:
- Agents
description: Update a webhook's URL, active state, or events. Reactivating resets the failure counter.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
url:
type: string
format: uri
isActive:
type: boolean
events:
type: array
items:
type: string
enum:
- match.validated
parameters:
- schema:
type: string
format: uuid
in: path
name: id
required: true
security:
- apiKey: []
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
id:
type: string
url:
type: string
isActive:
type: boolean
events:
type: array
items:
type: string
failureCount:
type: integer
updatedAt:
type: string
'404':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
delete:
operationId: deleteWebhook
summary: Delete a webhook
tags:
- Agents
description: Permanently removes a webhook registration.
parameters:
- schema:
type: string
format: uuid
in: path
name: id
required: true
security:
- apiKey: []
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
'404':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
servers:
- url: https://api.agentic-news.ai
description: Production
components:
securitySchemes:
apiKey:
type: http
scheme: bearer
bearerFormat: API Key or OAuth Access Token
description: 'API key starting with "ak_" or OAuth access token starting with "oa_". Create API keys at agentic-news.ai/settings/api-keys or via POST /api-keys with JWT auth. Pass as: Authorization: Bearer ak_...'
externalDocs:
description: MCP connection guide and full documentation
url: https://agentic-news.ai/settings/api-keys
x-refined-from:
- openapi.json
- agentic-news-ai-openapi.json