01
Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
Perigon
9 tools available
Perigon provides an HTTP REST API for retrieving news and web content data, offering structured data suitable for various applications.
Connect Perigon to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Perigon's 9 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Common workflows with Perigon
02
Daily summary
- Pull yesterday's activity
- Summarise with the model of your choice
- Send the digest via email or Slack
03
Cross-tool sync
- Read records from one app
- Transform with a persona
- Write the result back via this integration
Perigon actions 9
Every Perigon action below is a callable tool any Definable persona can invoke.
Get News Articles
Tool to retrieve a list of news articles based on filters. Use when keywords, sources, or date ranges are specified.
Get Companies
Tool to retrieve information on companies in Perigon’s entity database. Use when you need a full list of companies. Use after confirming a valid API key is present.
Get Journalists
Tool to retrieve journalist profiles including title, Twitter handle, bio, and location. Use when you need detailed journalist info to enrich content with author metadata.
Get Media Sources
Tool to retrieve a list of media sources with filtering options. Use when you need to list sources by domain, country, category, or traffic metrics.
Get Stories
Tool to retrieve clusters of related articles covering the same event or topic with aggregate metrics. Use when you need to fetch filtered and sorted story clusters after configuring query parameters.
Get Topics
Tool to retrieve all available Perigon news topics. Returns a list of topics that can be used to filter articles or stories. Each topic includes an ID, name, and labels (category/subcategory).
Get Wikipedia Articles
Tool to search and filter Wikipedia pages. Use when you have a search query ready and want to retrieve relevant Wikipedia articles.
Vector Search Articles
Tool to perform a vector search on Perigon’s real-time news database. Use when you need to retrieve semantically similar news articles given a natural language query.
Vector Search Wikipedia
Tool to perform semantic retrieval of Wikipedia pages using vector search. Use after obtaining a search query to find relevant Wikipedia articles.
Benzinga
Benzinga provides real-time financial news and data APIs, offering comprehensive coverage of market-moving information for developers and financial professionals.
Currents API
Currents News API provides access to the latest news articles from various sources worldwide, supporting multiple languages and categories.
Ecologi
Ecologi is the platform for collective climate action. Purchase trees and carbon offsets programmatically through their Impact API.
Hacker News
Hacker News is a tech-focused news aggregator by Y Combinator, featuring user-submitted stories and discussions on startups, programming, and emerging trends
More Trees
More Trees is a sustainability-focused platform planting trees on behalf of individuals or businesses aiming to offset carbon footprints and support reforestation
NewsAPI
News API is a simple HTTP REST API for searching and retrieving live articles from all over the web.
Frequently asked questions
What can I automate with Perigon on Definable?
Anything Perigon exposes through its API. Common news & lifestyle workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 9 Perigon tools directly, then chain the result into another integration without you writing code.
How does Perigon authentication work?
Perigon uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the Perigon integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 9 Perigon tools. You only need a separate Perigon subscription if Perigon itself charges per seat or per API call.
Is using Perigon through Definable secure?
Every call from a persona to Perigon is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with Perigon on Definable?
Sign up for Definable, open the integrations page, find Perigon, and connect via OAuth or API key. You can immediately attach Perigon to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What Perigon actions does Definable expose?
Definable exposes all 9 Perigon actions as callable tools — including `Get News Articles`, `Get Companies`, `Get Journalists`, plus 6 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with Perigon?
Wire it up in minutes. No coding required.