APIDevTools/swagger-parser

Health v2 · maintenance only

Adoption not part of the score

1205 stars · 171 forks observed · 2026-09-03

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A JavaScript library that parses, validates, resolves, bundles, and dereferences Swagger 2.0 and OpenAPI 3.0 specifications in JSON or YAML. It handles $ref pointers including external files, URLs, and circular references, and works in both Node.js and browsers.

Use cases

• validate an openapi spec against the schema
• parse swagger yaml files in node
• resolve $ref pointers across external files
• bundle multi-file openapi specs into one file
• dereference openapi spec into a plain javascript object
• lint and validate api definitions in ci

When to choose

• you need to parse or validate Swagger 2.0 / OpenAPI 3.0 documents in JavaScript
• your specs use external or circular $ref references
• you want a battle-tested parser validated against 1,500+ real-world APIs

When to avoid

• you need OpenAPI 3.1 support
• you are parsing non-OpenAPI JSON Schema documents
• you work outside the JavaScript ecosystem

Facets

library · maturity active

parser serialization developer-tools apis developer-tools parsers browser cross-platform openapi swagger -schema ref-resolution api-spec-validation yaml nodejs javascript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="APIDevTools/swagger-parser")