Skip to main content
WorldNewsAPI provides access to thousands of news sources across 210+ countries in 86+ languages, with 170,000+ news articles added daily in real-time. The platform offers semantic tagging, sentiment analysis, author extraction, and structured data extraction including images, videos, titles, descriptions, and publication dates. With the WorldNewsAPI integration in Relevance AI, you can search news with advanced filters, extract structured data from news URLs, and convert location names to coordinates for location-based news searches—all directly within your AI workflows.
The WorldNewsAPI integration in Relevance AI was built by Relevance AI, and is therefore supported by our team, not WorldNewsAPI. If you have a question or issue with using WorldNewsAPI in Relevance AI, please reach out to our support team. If you have a question or issue that is only about WorldNewsAPI, you can reach out to WorldNewsAPI support.

​
About WorldNewsAPI

WorldNewsAPI is a comprehensive news data platform that provides:
  • Global Coverage: Access to thousands of news sources from 210+ countries
  • Multi-language Support: Content in 86+ languages
  • Real-time Updates: 170,000+ new articles added daily
  • Advanced Features: Semantic tagging, sentiment analysis, author extraction
  • Rich Media: Automatic extraction of images, videos, titles, descriptions, and dates
  • Powerful Search: Semantic search with filters for country, language, time, sentiment, entities, sources, and authors
This is a native integration that replaces the previous Pipedream version, offering improved reliability and performance.

​
Connect the integration

Connecting your WorldNewsAPI account to Relevance AI requires an API key:
  1. Go to the “Integrations” page in the sidebar of your Relevance AI dashboard.
  2. Click on “WorldNewsAPI” from the available integrations.
  3. Click on the “Add Integration” button.
  4. Enter your WorldNewsAPI API key when prompted.
  5. Once authenticated, your WorldNewsAPI account will appear as a connected integration.
To get your WorldNewsAPI API key:
  1. Sign up at https://worldnewsapi.com/
  2. Confirm your email address
  3. Go to your Profile page
  4. Click “Show/Hide API Key” to reveal your key

​
Tool steps for WorldNewsAPI

The WorldNewsAPI integration provides ready-made actions that your agents can use to search news, extract article data, and work with location-based searches. These actions can be incorporated into your agent’s workflows as tool steps.

​
News Search & Discovery

Search News

Search thousands of news sources with filters for 50+ languages, 150+ countries, date ranges, sentiment, entities, sources, and authors

Extract News from URL

Extract structured data from any news article URL including title, text, images, videos, publish date, authors, language, source country, and sentiment

​
Location Services

Get Geo Coordinates

Convert location names to latitude and longitude coordinates for location-based news searches

​
Advanced API Access

WorldNewsAPI API Call

Make custom API calls to access any WorldNewsAPI endpoint for advanced use cases
Type “WorldNewsAPI” in the tool step search bar to see all available actions when building your tools.

​
Use the integration’s API tool step (Advanced)

In addition to the pre-built actions available in the tool directory, you can build custom tools that perform WorldNewsAPI-specific activities using the WorldNewsAPI API Call tool step.

​
How to use the API Call tool step

1

Create a new tool

Create a new tool in Relevance AI or open an existing tool you want to add WorldNewsAPI functionality to.
2

Add the WorldNewsAPI API Call tool step

  1. Scroll down to Tool-steps
  2. Search for “WorldNewsAPI API Call” in the tool step search bar
  3. Add the WorldNewsAPI API Call tool step to your workflow
3

Select your WorldNewsAPI account

Select your connected WorldNewsAPI account from the dropdown menu.
4

Configure the API endpoint

Configure the API endpoint, method, and parameters according to your needs:
  • Method: Select the HTTP method (GET, POST)
  • Endpoint: Enter the API endpoint path (e.g., /search-news)
  • Parameters: Add query parameters for filtering and search criteria
5

Test your API call

Test your configuration to ensure it works correctly before deploying.

​
Example: Search News with Custom Filters

Here’s a practical example of using the WorldNewsAPI API Call tool step to search for technology news with sentiment filtering: API Endpoint: GET /search-news Configuration: 
{
  "method": "GET",
  "endpoint": "/search-news",
  "params": {
    "text": "artificial intelligence",
    "language": "en",
    "sentiment": "positive",
    "earliest-publish-date": "2026-03-01",
    "number": 10
  }
}
This configuration:
  • Searches for articles about “artificial intelligence”
  • Filters for English language content
  • Returns only positive sentiment articles
  • Limits results to articles published after March 1, 2026
  • Returns up to 10 results
You can find WorldNewsAPI’s complete API documentation at https://worldnewsapi.com/docs/.

​
Common API endpoints

Endpoint: GET /search-newsSearch news articles with advanced filtering options:
  • text: Search query text
  • language: Filter by language code (e.g., “en”, “es”, “fr”)
  • source-countries: Filter by country codes
  • sentiment: Filter by sentiment (positive, negative, neutral)
  • entities: Filter by named entities
  • earliest-publish-date: Start date for results
  • latest-publish-date: End date for results
  • number: Number of results to return
Returns: Array of news articles with full metadataView API Documentation
Endpoint: GET /extract-newsExtract structured data from a news article URL:
  • url: The news article URL to extract from
  • analyze: Whether to include sentiment analysis
Returns: Title, text, images, videos, publish date, authors, language, source country, sentimentView API Documentation
Endpoint: GET /geo-coordinatesConvert location names to coordinates:
  • location: Location name to geocode
Returns: Latitude and longitude coordinatesUseful for location-based news searches and mapping.View API Documentation
Endpoint: GET /top-newsGet top news headlines:
  • source-country: Country code for news sources
  • language: Language code
  • date: Date for top news
Returns: Top headlines for the specified criteriaView API Documentation

​
Example use cases

Here are some ways you can leverage the WorldNewsAPI integration with your agents:
Create an agent that monitors news mentions of your brand, products, or key executives. The agent searches for relevant articles, analyzes sentiment, and sends alerts when negative coverage is detected or when your brand appears in major publications.
Build an agent that tracks competitor mentions across global news sources. The agent monitors product launches, executive changes, funding announcements, and market moves, then compiles daily intelligence briefings for your team.
Deploy an agent that analyzes news trends in your industry. The agent tracks emerging topics, sentiment shifts, and geographic patterns, providing insights into market dynamics and consumer sentiment.
Create an agent that builds curated news feeds for specific topics, industries, or regions. The agent filters by language, sentiment, and relevance, then formats articles for your website, newsletter, or internal dashboard.
Build an agent that monitors for breaking news and crisis situations relevant to your organization. The agent searches for keywords related to potential risks, analyzes sentiment and urgency, and sends real-time alerts to stakeholders.
Deploy an agent that aggregates news from multiple languages and regions. The agent searches news in different languages, translates key articles, and creates a comprehensive international news digest for global teams.
Create an agent that tracks sentiment trends for specific topics over time. The agent collects articles, analyzes sentiment patterns, and generates reports showing how public perception is evolving.
Build an agent that monitors news for specific geographic locations. The agent uses geo-coordinates to find local news, tracks regional events, and alerts relevant teams about location-specific developments.

​
Best practices

Manage your API usage effectively:
  • Rate limits depend on your WorldNewsAPI plan
  • Implement retry logic with exponential backoff for rate limit errors
  • Cache search results when appropriate to reduce API calls
  • Use specific filters to reduce result set sizes
  • Monitor your API usage through the WorldNewsAPI dashboard
  • Consider upgrading your plan if you consistently hit limits
Get better search results:
  • Use specific search terms rather than broad queries
  • Combine multiple filters (language, country, date) to narrow results
  • Use sentiment filters to focus on relevant coverage
  • Specify date ranges to get timely results
  • Use entity filters to find articles mentioning specific people or organizations
  • Test different search queries to find the most effective terms
Ensure high-quality data:
  • Validate extracted article data before using it
  • Handle cases where extraction fails or returns incomplete data
  • Check sentiment scores for reliability
  • Verify publication dates are within expected ranges
  • Filter out duplicate articles from different sources
  • Implement fallback logic for missing data fields
Optimize workflow performance:
  • Limit the number of results per search to what you actually need
  • Use pagination for large result sets
  • Process articles in batches rather than one at a time
  • Cache frequently accessed data
  • Schedule regular searches rather than real-time queries when possible
  • Use webhooks or scheduled runs instead of continuous polling

​
Frequently asked questions (FAQs)

WorldNewsAPI supports 86+ languages including English, Spanish, French, German, Chinese, Japanese, Arabic, Portuguese, Russian, and many more. You can filter search results by language code (e.g., “en” for English, “es” for Spanish).
WorldNewsAPI provides access to thousands of news sources across 210+ countries. The exact number varies as sources are continuously added and updated. Coverage includes major international publications, regional news outlets, and specialized industry sources.
The native WorldNewsAPI integration is built directly into Relevance AI, offering better reliability, performance, and support. The Pipedream version (now renamed “World News API (Pipedream)”) is being deprecated. We recommend using the native integration for all new workflows.
To get your API key:
  1. Visit https://worldnewsapi.com/
  2. Sign up for an account
  3. Confirm your email address
  4. Log in and go to your Profile page
  5. Click “Show/Hide API Key” to reveal your key
Keep your API key secure and never share it publicly.
Yes, rate limits depend on your WorldNewsAPI subscription plan. Free plans have lower limits, while paid plans offer higher request volumes. Check your WorldNewsAPI account dashboard for your specific limits. If you hit rate limits, implement retry logic in your workflows.
WorldNewsAPI uses advanced natural language processing for sentiment analysis. While generally accurate, sentiment detection can vary based on article complexity, language, and context. We recommend reviewing sentiment scores and implementing confidence thresholds for critical use cases.
Yes, you can search across multiple languages by making separate API calls for each language or by not specifying a language filter (which returns results in all languages). You can then filter or process the results based on your needs.
WorldNewsAPI adds 170,000+ articles daily in real-time. New articles typically appear in search results within minutes of publication. However, the exact timing depends on when the source publishes and how quickly it’s indexed.
The Extract News tool works with most news article URLs. However, some sites may block automated extraction or have paywalls. The tool extracts publicly accessible content and structured data like titles, images, videos, authors, and publication dates.
Geo coordinates (latitude and longitude) allow you to search for news from specific geographic locations. This is useful for finding local news, tracking regional events, or monitoring news from areas relevant to your business operations.
Yes, you can filter search results by specific news sources or domains using the source filters in your search queries. This is useful when you want to monitor specific publications or exclude certain sources.
WorldNewsAPI maintains an extensive archive of historical news articles. The exact coverage period varies by source, but many sources have archives going back several years. Use the date range filters to search historical content.