View as Markdown
World News API icon

World News API TRIGGER

Published News

Emit new event whenever recent news are published. Calling this endpoint requires 1 point per page, up to 1000 news. See the docs here
  • Trigger
  • Polling
  • API key
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's World News API account, configure the source, and choose the webhook where your backend receives events.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const deployed = await pd.triggers.deploy({
  id: "world_news_api-published-news",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    world_news_api: { authProvisionId: "apn_xxxxxxx" },
    timer: { "intervalSeconds": 900 },
    text: "Text",
  },
  webhookUrl: "https://example.com/webhooks/world-news-api",
})

console.log(deployed.id)

MCP exposes on-demand actions. Event sources are deployed through the Connect SDK or API because they continue listening after the initial request.

SCHEMA

Configuration

These inputs define which events the source watches. Dynamic options are loaded from the connected account.

Published News configuration
Property Type Description
timer Polling Interval $.interface.timer
Pipedream will poll the World News API on this schedule
Required
text Text string
The text to match in the news content.
Optional
sourceCountries Source Countries string[]
List of ISO 3166 country codes from which the news should originate.
Optional
language Language string
The ISO 6391 language code of the news.
Optional
minSentiment Minimum Sentiment string
The minimum sentiment of the news.
Optional
maxSentiment Maximum Sentiment string
The maximum sentiment of the news.
Optional
newsSources News Sources string[]
A list of news sources from which the news should originate.
Optional
authors Authors string[]
A list of authors of the news.
Optional
entities Entities string[]
Filter news by entities (see semantic types).
Optional
locationFilter Location Filter string
Filter news by radius around a certain location. Format is latitude,longitude,radius in kilometers
Optional

01

Connect

Your user authorizes World News API through Pipedream managed auth.

02

Deploy

Your backend deploys this source with that user's own configuration.

03

Webhook delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source — after each poll.

OR

On-demand retrieval

No webhook required. Your app or agent can fetch recent events from the trigger events API.

Registry key
world_news_api-published-news
Version
0.0.1
App
World News API
Authentication
API key
Delivery
Polling source
Output
Events emitted by World News API.