APIs.io · OpenAPI Overlay 1.0.0

API Evangelist enhancements for .io Search APIs Synthesis API

2 actions 2 updates update extends openapi/apis-io-synthesis-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for APIs.io's API. It is a proposal applied on top of the contract, not a document APIs.io publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-enrichedx-apis-io-error-envelopex-apis-io-tier-gate-statusx-apis-io-mcpx-apis-io-api-catalogx-apis-io-llms-txt

Targets 2

$.servers

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for .io Search APIs Synthesis API
  version: 1.0.0
extends: openapi/apis-io-synthesis-api-openapi.yml
x-generated: '2026-08-10'
x-method: generated
x-source: live probes of https://apis.io/api/v1 + https://apis.io/developer/overview
actions:
- target: $.servers
  description: Correct the server host. The harvested spec declares https://search-api.apis.io, which
    has NO DNS record (dig returns empty; curl cannot connect). The live production base URL is https://apis.io/api/v1,
    verified 200 on 2026-08-10.
  update:
  - url: https://apis.io/api/v1
    description: Production server.
- target: $.info
  update:
    x-apievangelist-enriched: '2026-08-10'
    x-apis-io-error-envelope: Deployed responses use application/json {error, detail}, not the declared
      application/problem+json.
    x-apis-io-tier-gate-status: 402
    x-apis-io-mcp: https://apis.io/mcp
    x-apis-io-api-catalog: https://apis.io/.well-known/api-catalog
    x-apis-io-llms-txt: https://apis.io/llms.txt