Perigon News & Stories API
Endpoints for accessing news articles and stories
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
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}.
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.
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.
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}.
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}.