World News API · OpenAPI Overlay 1.0.0

API Evangelist enhancements for World News Extract News Top News API

5 actions 5 updates update extends openapi/worldnewsapi-top-news-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for World News API's API. It is a proposal applied on top of the contract, not a document World News API publishes.
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['/top-news'].get

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist enhancements for World News Extract News Top News API
  version: 1.0.0
extends: openapi/worldnewsapi-top-news-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['/top-news'].get
  update:
    x-apievangelist-operation-id: topNews
    x-apievangelist-errors: [401, 402, 403, 404, 406, 429]