Astronomy API · OpenAPI Overlay 1.0.0

API Evangelist enhancements — Astronomy API search-api

2 actions 2 updates update extends ./astronomy-api-search-api-openapi.yml

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apis-iox-runtime-notesx-agentic-access

Targets 2

$.info

$.paths['/search'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements — Astronomy API search-api
  version: 1.0.0
  x-generated: '2026-09-04'
  x-method: generated
  x-source: API Evangelist enrichment pipeline — records this repo's own derived and searched artifacts
    against the provider's unmodified specification.
  x-note: 'Adds only API Evangelist annotations: cross-references to the artifacts in this repo, the runtime
    conditions the provider documents in prose but never declares in the contract (429, 504, 403-on-auth-failure),
    and the derived x-agentic-access classification from agentic-access/astronomy-api-agentic-access.yml.
    The provider''s specification is never mutated.'
extends: ./astronomy-api-search-api-openapi.yml
actions:
- target: $.info
  description: Attach API Evangelist artifact cross-references and provenance.
  update:
    x-apis-io:
      provider: astronomy-api
      record: https://apis.io/astronomy-api/
      artifacts:
        conventions: conventions/astronomy-api-conventions.yml
        errors: errors/astronomy-api-problem-types.yml
        lifecycle: lifecycle/astronomy-api-lifecycle.yml
        rateLimits: rate-limits/astronomy-api-rate-limits.yml
        authentication: authentication/astronomy-api-authentication.yml
        dataModel: data-model/astronomy-api-data-model.yml
        conformance: conformance/astronomy-api-conformance.yml
        plans: plans/astronomy-api-plans-pricing.yml
        toolCrosswalk: mcp/astronomy-api-tool-crosswalk.yml
    x-runtime-notes:
      rate-limit: HTTP 429 is enforced on IP and overall consumption. No RateLimit-* or Retry-After header
        is served; the provider says only to retry "after some time". See rate-limits/astronomy-api-rate-limits.yml.
      timeout: HTTP 504 is a documented condition on the studio endpoints and the provider states an identical
        retry succeeds.
      auth-failure-status: v2 answers a bad credential with 403, not 401.
      error-shape: v2 returns raw JSON-Schema validator output under `errors[]` with no stable code. See
        errors/astronomy-api-problem-types.yml.
      source: https://docs.astronomyapi.com/known-issues and https://docs.astronomyapi.com/requests-and-response/error-responses
- target: $.paths['/search'].get
  description: Attach the derived agentic-access execution class for this operation.
  update:
    x-agentic-access:
      action-class: connected
      consequence: read
      subject: optional
      token:
        max-ttl: 3600
      audit: none

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/astronomy-api-search-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.