Perigon

news & lifestyle 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 Visit Perigon

About this integration

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.

Connect Perigon to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.

Auth OAuth2 · 2 clicks

Tools 9 exposed

Plans All, incl. Free

Data Never trained on

Perigon · in workflows

What teams actually run.

Three patterns teams run with Perigon on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.

Trigger on event

│ Listen for a new event

│ Parse and validate the payload

└ Take an action with the linked tool

Daily summary

│ Pull yesterday's activity

│ Summarise with the model of your choice

└ Send the digest via email or Slack

Cross-tool sync

│ Read records from one app

│ Transform with a persona

└ Write the result back via this integration

9 tools available

The Perigon toolbox.

Every Perigon capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.

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.

See it run

One prompt, start to finish.

A real prompt, the Perigon tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.

❯

Run a real Perigon task end-to-end — plan it, execute across the API, and hand back a verified result.

perigon.get_news_articles Tool to retrieve a list of news articles based on filters. Use when keywords, sources, or

perigon.get_companies Tool to retrieve information on companies in Perigon’s entity database. Use when you need

perigon.get_journalists Tool to retrieve journalist profiles including title, Twitter handle, bio, and location. U · verified

done

Done. Perigon responded across 3 calls, the verifier signed off, and the result is logged with every payload.

FAQ · Perigon

Questions, answered.

What teams ask before connecting Perigon.

01 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.

02 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.

03 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.

04 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.

05 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.

06 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.