Hanzo
OpenapiWorld

Returns the caller's merged world-news feed: every source their project's…

Returns the caller's merged world-news feed: every source their project's pipeline names — GDELT once per keyword, plus each allowlisted RSS or Atom feed…

GET /v1/world/news

Addresshttps://api.hanzo.ai/v1/world/news
MethodGET
Operationget_world_news
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the caller's merged world-news feed: every source their project's pipeline names — GDELT once per keyword, plus each allowlisted RSS or Atom feed — fetched concurrently, narrowed by the pipeline's keyword/region/source filters, deduplicated by link and sorted freshest first, capped at 50 items.

A project with no stored pipeline gets a sensible default set of world feeds rather than an empty answer. A source that fails or times out is SKIPPED: the feed degrades to honest partial results and never 5xxs because one outlet was down. Reading also publishes the result to the /v1/world/stream subscribers of the same (org, project), so a dashboard's own refresh updates every open tab.

Request

GET /v1/world/news takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200newsResponseok

200 body — 8 fields.

FieldInTypeAlwaysDescription
itemsbodyNewsItem[]Items is the merged, filtered, deduped feed, freshest first and capped at 50.
items[].imagebodystringImage is a lead-image URL when the upstream carried one.
items[].langbodystringLang is the article's language code when the upstream reported one.
items[].linkbodystringLink is the article's URL at the outlet.
items[].pubDatebodystringPubDate is when the outlet published it, RFC3339 UTC.
items[].sourcebodystringSource is the outlet the item came from, as the upstream named it.
items[].titlebodystringTitle is the headline.
items[].tonebodystringTone is GDELT's own sentiment score for the article, as text.

Failure carries the platform error shape — see Errors.

Examples

hanzo world news

World API · All Hanzo APIs · Interactive reference

How is this guide?

On this page