Skip to main content
Perigon logo
  • Category: web search & research
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 9
  • Triggers: 0
  • Slug: PERIGON
  • Version: 20261014_00

Tools

Slug: PERIGON_GET_ARTICLESTool to retrieve a list of news articles based on filters. Use when keywords, sources, or date ranges are specified.

Input Parameters

string
Search query term or phrase
string
Newest date for articles (YYYY-MM-DD or ISO8601)
string
Oldest date for articles (YYYY-MM-DD or ISO8601)
integer
Page number (1-indexed)
string ("relevancy" | "popularity" | "publishedAt")
Order to sort articles
string
2-letter country code to filter news sources
string
Comma-separated list of domain names to include
string
Comma-separated list of source IDs
string
Article category, e.g., technology, sports
string
2-letter language code, e.g., ‘en’
integer
Number of results per page (1-100)
string
Comma-separated list of domain names to exclude

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PERIGON_GET_COMPANIESTool 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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PERIGON_GET_JOURNALISTSTool to retrieve journalist profiles including title, Twitter handle, bio, and location. Use when you need detailed journalist info to enrich content with author metadata.

Input Parameters

integer
Number of items to return (default: 10, max: 100)
string
Search string for journalist name
integer
Number of items to skip for pagination
string
Filter journalists by outlet name

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PERIGON_GET_SOURCESTool to retrieve a list of media sources with filtering options. Use when you need to list sources by domain, country, category, or traffic metrics.

Input Parameters

integer
Page number for pagination (default: 1)
string
Filter by domain of the source (e.g., cnn.com)
string
Filter by country code (ISO-3166-1 alpha-2, e.g., US)
string ("general" | "sports" | "technology" | "business" | "entertainment" | "health" | "science")
Filter by category of the source
string
Filter by language code (ISO-639-1, e.g., en)
integer
Results per page (default: 10, max: 100)
integer
Filter for sources with maximum stories per month
integer
Filter for sources with a maximum SimilarWeb global rank
integer
Filter for sources with minimum stories per month
integer
Filter for sources with a minimum SimilarWeb global rank
string
Comma-separated list of domains to exclude
string
Comma-separated list of domains to include

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PERIGON_GET_STORIESTool 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.

Input Parameters

string
Search query keywords or phrases
string
Comma-separated story IDs
integer
Page number for pagination
string
Story type, e.g., ‘story’, ‘opinion’, ‘analysis’
boolean
Only stories with images
boolean
Only stories with videos
string
Comma-separated domains to filter by
string
Sort method for story results (default: createdAt)
integer
Only show stories in a given cluster
string
Country code, e.g., ‘us’
string
Exclude comma-separated story IDs
boolean
Only paywalled or non-paywalled content
string
Comma-separated source IDs to filter by
string
End date for filtering stories in ISO 8601 format
string
News category, e.g., ‘sports’
string
Language code, e.g., ‘en’
string
Start date for filtering stories in ISO 8601 format
number
Maximum Perigon story score
number
Minimum Perigon story score
string ("positive" | "neutral" | "negative")
Filter by sentiment
number
Minimum clustering score

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PERIGON_GET_TOPICSTool 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).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PERIGON_GET_WIKIPEDIATool to search and filter Wikipedia pages. Use when you have a search query ready and want to retrieve relevant Wikipedia articles.

Input Parameters

string
required
Search query for the Wikipedia articles
integer
Page number for pagination (default: 1)
integer
Number of results per page (default: 10, maximum: 100)
string
Two-letter Wikipedia language code (e.g., ‘en’, ‘es’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PERIGON_VECTOR_SEARCH_ARTICLESTool 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.

Input Parameters

string
required
Natural language search text to vectorize and find similar articles
integer
Number of top results to return, must be >=1
object
Optional filters to narrow down results (source, category, language)
object
Advanced vector search options like model override
boolean
Whether to include article vectors in response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PERIGON_VECTOR_SEARCH_WIKIPEDIATool to perform semantic retrieval of Wikipedia pages using vector search. Use after obtaining a search query to find relevant Wikipedia articles.

Input Parameters

integer
Maximum number of results to return (default: 10)
string
required
Search query for Wikipedia pages
boolean
Whether to include context passages in the response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not