Perigon

Perigon News & Stories API

Endpoints for accessing news articles and stories

GitHub OpenAPI

Operations 8

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/articles/all Search news articles · All Articles #
Ask an LLM
“How do I search news articles by keyword, source and date range?”
“Can I find articles that mention a specific company or person?”
Tell an agent
Find news articles about {q} published since {from}.
Search articles mentioning {companyName} from {source}.
POST /v1/articles/refresh/jobs Queue articles for a background refresh · Submit an article refresh job #
Ask an LLM
“How do I ask for updated data on a batch of articles I already have?”
“Can I schedule a refresh for articles that aren't in the fresh cache yet?”
Tell an agent
Submit a refresh job for articles {articleIds}.
Start a background refresh of article IDs {articleIds} and give me the job id.
GET /v1/articles/refresh/jobs/{id} Check an article refresh job's status · Get article refresh job status #
Ask an LLM
“Is my article refresh job finished yet?”
“Can I see partial results from a refresh job while it is still running?”
Tell an agent
Check the status of refresh job {id}.
Get the per-article results computed so far for refresh job {id}.
POST /v1/articles/refresh/peek Peek at cached refreshed article data · Peek cached article refresh data #
Ask an LLM
“Can I see already-cached refreshed article data without starting a new job?”
“What refreshed data is available right now for some articles, best effort?”
Tell an agent
Peek at cached refresh data for articles {articleIds} without queuing a job.
Return whatever refreshed data is already cached for {articleIds}.
GET /v1/stories/all Search clustered news stories · Stories #
Ask an LLM
“How can I follow an evolving news story rather than individual articles?”
“Which top stories right now involve a particular company?”
Tell an agent
Find news stories about {q} updated since {updatedFrom}.
Show stories involving {companyName} covered by at least {minUniqueSources} sources.
GET /v1/stories/history Get a story's past versions and changelog · Story History #
Ask an LLM
“How has a news story's summary changed over time?”
“Can I see the changelog for previous versions of a story cluster?”
Tell an agent
Show the version history of story {clusterId}.
Get earlier versions of story {clusterId} between {from} and {to} that include a changelog.
GET /v1/stories/stats Count stories over time · Story Count Statistics #
Ask an LLM
“How many news stories about a topic appeared each day this month?”
“Can I chart story volume by week or by hour?”
Tell an agent
Count stories about {q} grouped by {splitBy}.
Give me story counts per {splitBy} for {companyName} since {from}.
POST /v1/vector/news/all Semantic search over recent news · News (Vector) #
Ask an LLM
“Can I search news with a natural-language question instead of keywords?”
“How far back does the semantic news search go?”
Tell an agent
Run a semantic news search for {prompt}.
Find the news articles most relevant to {prompt} published after {pubDateFrom}.

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-news-stories-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-news-stories-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-news-stories-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Perigon News & Stories 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 (169 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/perigon/refs/heads/main/openapi/perigon-news-stories-api-openapi.yml