Skip to main content
Perigon is a comprehensive news API that provides access to real-time contextual information in news articles, stories, metadata and wikipedia pages from thousands of sources worldwide.

​
Installation and Setup

Perigon integration exists in its own partner package. You can install it with: 
pip install -qU langchain-perigon
In order to use the package, you will also need to set the PERIGON_API_KEY environment variable to your Perigon API key.

​
Retrievers

Perigon provides two retrievers:

​
ArticlesRetriever

This retriever retrieves articles based on a given query and optional filters. See a full usage example. 
# Make sure PERIGON_API_KEY environment variable is set to your Perigon API key
from langchain_perigon import ArticlesRetriever, ArticlesFilter

# Create retriever with specific number of results
retriever = ArticlesRetriever(k=12)

# Configure filter options to exclude reprints and focus on US articles
options: ArticlesFilter = {
    "showReprints": False,  # Exclude duplicate/reprint articles
    "filter": {"country": "us"},  # Only US-based news
}

try:
    documents = retriever.invoke("Recent big tech layoffs", options=options)

    # Check if we got results before accessing
    if documents:
        print(f"First document: {documents[0].page_content[:200]}...")
    else:
        print("No articles found for the given query.")
except Exception as e:
    print(f"Error retrieving articles: {e}")
You can use the ArticlesRetriever in a standard retrieval pipeline:

​
WikipediaRetriever

This retriever retrieves wikipedia pages based on a given query and optional filters. See a full usage example. 
# Make sure PERIGON_API_KEY environment variable is set to your Perigon API key
from langchain_perigon import WikipediaRetriever

# Create retriever with specific number of results
retriever = WikipediaRetriever(k=12)

try:
    documents = retriever.invoke("machine learning")

    # Safely access results with error handling
    if documents:
        print(f"First document: {documents[0].page_content[:200]}...")
    else:
        print("No Wikipedia articles found for the given query.")
except Exception as e:
    print(f"Error retrieving Wikipedia articles: {e}")
You can use the WikipediaRetriever in a standard retrieval pipeline:
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I