Perigon

Perigon Monitors API

Manage AI Monitors — configurable monitors that continuously scan news content for topics, entities, and events of interest. Monitors run asynchronously and emit structured events and AI-generated summaries that can be delivered to contact points.

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/api/monitors List AI news monitors · List monitors #
Ask an LLM
“Which AI monitors does my organization have running?”
“Can I include archived monitors when listing them?”
Tell an agent
List my monitors sorted by {sortBy} {sortOrder}.
Show monitors with status {status}, newest first by {sortBy} in {sortOrder} order.
POST /v1/api/monitors Create an AI news monitor · Create monitor #
Ask an LLM
“How do I set up an AI monitor that watches the news for a specific signal?”
“Can a new monitor start as a draft rather than going live immediately?”
Tell an agent
Create a monitor called {name} with objective {monitoringObjective}, classification {classificationType}, query {query} and schema {dataSchema}.
Set up a draft monitor {name} tracking {monitoringObjective} using watchlist {watchlistId}, schema {dataSchema}, query {query}, type {classificationType}.
GET /v1/api/monitors/{uuid} Get a monitor's configuration · Get monitor #
Ask an LLM
“What objective and query is a given monitor configured with?”
“Can I check whether one specific monitor is active or paused?”
Tell an agent
Show me the configuration of monitor {uuid}.
Fetch monitor {uuid} and report its current status.
DELETE /v1/api/monitors/{uuid} Archive a monitor · Archive monitor #
Ask an LLM
“How do I retire a monitor so it stops showing up in my list?”
“Does archiving a monitor hide it from list results?”
Tell an agent destructive · confirm first
Archive monitor {uuid}.
Retire the monitor {uuid} by archiving it.
PATCH /v1/api/monitors/{uuid} Edit a monitor's settings · Update monitor #
Ask an LLM
“Can I change the query or objective of a monitor I already created?”
“How do I switch which contact points an existing monitor notifies?”
Tell an agent
Change monitor {uuid} to track {monitoringObjective} with query {query}.
Edit monitor {uuid} so it notifies contact points {contactPointIds}.
POST /v1/api/monitors/{uuid}/activate Activate a monitor · Activate monitor #
Ask an LLM
“How do I turn on a draft or paused monitor so it starts processing news?”
“Can I restart a monitor I paused earlier?”
Tell an agent
Activate monitor {uuid}.
Start processing for monitor {uuid} again.
GET /v1/api/monitors/{uuid}/events List events a monitor detected · List monitor events #
Ask an LLM
“What matching articles or events has my monitor detected?”
“Can I filter a monitor's detected events by event type or date range?”
Tell an agent
List events from monitor {uuid} sorted by {sortBy} {sortOrder}.
Show {eventType} events detected by monitor {uuid} since {from}, sorted by {sortBy} {sortOrder}.
GET /v1/api/monitors/{uuid}/newsletters List a monitor's newsletter digests · List monitor newsletters #
Ask an LLM
“Where can I read the newsletter digests my monitor has produced?”
“Can I search a monitor's newsletters by title?”
Tell an agent
List newsletters generated by monitor {uuid}, sorted by {sortBy} {sortOrder}.
Find newsletters titled {title} for monitor {uuid}, ordered by {sortBy} {sortOrder}.
POST /v1/api/monitors/{uuid}/pause Pause a monitor · Pause monitor #
Ask an LLM
“How do I temporarily stop a monitor without archiving it?”
“Is there a way to halt a monitor's processing pipeline for now?”
Tell an agent
Pause monitor {uuid}.
Stop monitor {uuid} from processing for the time being.
GET /v1/api/monitors/{uuid}/summary List a monitor's AI summaries · List monitor summaries #
Ask an LLM
“What AI-generated summaries has my monitor written about the content it matched?”
“Can I get only the monitor summaries produced in a certain date window?”
Tell an agent
List AI summaries for monitor {uuid} sorted by {sortBy} {sortOrder}.
Show summaries from monitor {uuid} between {from} and {to}, sorted by {sortBy} {sortOrder}.

Documentation

📖
Documentation
https://perigon.io/docs/api/intro
📖
APIReference
https://perigon.io/reference
📖
GettingStarted
https://perigon.io/docs/api/getting-started

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/perigon/refs/heads/main/openapi/perigon-monitors-api-openapi.yml

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/perigon:perigon-monitors-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

perigon-monitors-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Perigon Monitors API
  description: The Perigon API provides access to comprehensive news and web content data. To use the API, simply sign up for a Perigon Business Solutions account to obtain your API key. Your available features may vary based on your plan. See the Authentication section for details on how to use your API key.
  contact:
    name: Perigon Support
    url: https://docs.perigon.io/
    email: data@perigon.io
  version: 1.0.0
servers:
- url: https://api.perigon.io
  description: Generated server url
security:
- apiKeyAuth: []
tags:


# --- truncated at 32 KB (89 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/perigon/refs/heads/main/openapi/perigon-monitors-api-openapi.yml