World News API · OpenAPI Overlay 1.0.0

API Evangelist enhancements for World News Extract News Front Pages API

5 actions 5 updates update extends openapi/worldnewsapi-front-pages-api-openapi.yml

Derived by API Evangelist Built from the contracts World News API publishes. World News API did not publish this file.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-provider-openapix-apievangelist-contract-versionx-apievangelist-artifactsx-apievangelist-meteringx-apievangelist-idempotencyx-apievangelist-agent-surfacex-apievangelist-operation-id

Targets 2

$.info

$.paths['/retrieve-front-page'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for World News Extract News Front Pages API
  version: 1.0.0
extends: openapi/worldnewsapi-front-pages-api-openapi.yml
x-provenance:
  generated: '2026-08-13'
  method: generated
  source: >-
    Enhancements derived from artifacts already in this repository - the
    provider-published OpenAPI at
    openapi/_original/worldnewsapi-openapi-original.json, the live MCP tools/list
    at mcp/worldnewsapi-mcp-tools.json, conventions/worldnewsapi-conventions.yml
    and errors/worldnewsapi-problem-types.yml. The overlay never mutates the
    underlying document.
actions:
- target: $.info
  update:
    x-apievangelist-provider: worldnewsapi
    x-apievangelist-provider-openapi: >-
      https://raw.githubusercontent.com/ddsky/world-news-api-clients/main/world-news-api-openapi-3.json
    x-apievangelist-contract-version: '2.2.0'
    x-apievangelist-artifacts:
      conventions: conventions/worldnewsapi-conventions.yml
      errors: errors/worldnewsapi-problem-types.yml
      data-model: data-model/worldnewsapi-data-model.yml
      lifecycle: lifecycle/worldnewsapi-lifecycle.yml
      rate-limits: rate-limits/worldnewsapi-rate-limits.yml
      plans: plans/worldnewsapi-plans-pricing.yml
      mcp: mcp/worldnewsapi-mcp.yml
      crosswalk: mcp/worldnewsapi-tool-crosswalk.yml
      skills: skills/_index.yml
- target: $.info
  update:
    x-apievangelist-metering:
      unit: point
      baseline: 1 point per request plus 0.01 points per result returned
      quota_headers: [X-API-Quota-Request, X-API-Quota-Used, X-API-Quota-Left]
      exhaustion_status: 402
      throttle_status: 429
      retry_after: false
      docs: https://worldnewsapi.com/docs/quotas-and-rate-limiting/
- target: $.info
  update:
    x-apievangelist-idempotency:
      supported: false
      reason: every published operation is a GET; the API exposes no write surface
- target: $.info
  update:
    x-apievangelist-agent-surface:
      mcp_deployment: local-stdio
      mcp_package: world-news-api-mcp
      mcp_remote_endpoint: null
      agent_card: null
- target: $.paths['/retrieve-front-page'].get
  update:
    x-apievangelist-operation-id: retrieveFrontPage
    x-apievangelist-errors: [401, 402, 403, 404, 406, 429]

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/worldnewsapi-front-pages-api-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.