# marshmallow-code/apispec

A pluggable API specification generator. Currently supports the OpenAPI Specification (f.k.a. the Swagger specification)..

Repository: https://github.com/marshmallow-code/apispec
Canonical: https://ross.abutalabs.com/products/apispec
Homepage: https://apispec.readthedocs.io/
Language: Python
License: MIT
License Family: permissive
Topics: openapi, swagger, python, marshmallow, rest-api, documentation, flask, pluggable, api, http-api, json-schema, openapi-specification, openapi3, openapi2
Last push: 2026-08-03T19:11:49+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 35, longevity 100
- inputs: {"age_days": 4337, "days_push": 30, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1219, forks 201 (observed 2026-08-28T04:04:01.769730+00:00)

## What it is
A pluggable Python library that generates OpenAPI (Swagger) specifications, supporting OpenAPI versions 2 and 3. It is framework-agnostic with built-in marshmallow schema support and utilities for parsing docstrings.

## Use cases
- generate an OpenAPI spec from a Flask app
- document REST APIs with OpenAPI 3
- generate swagger documentation from marshmallow schemas
- extract API specs from docstrings
- build OpenAPI definitions for a Python web framework

## When to choose
- you use marshmallow schemas and want OpenAPI docs generated from them
- you need a framework-agnostic OpenAPI spec generator in Python
- you want to document Flask or similar REST APIs

## When to avoid
- you need a full interactive documentation UI rather than spec generation
- your API is not Python-based
- you want automatic spec generation without any schema or docstring annotations

## Facets
- artifact type: library
- maturity: active
- function: api-documentation, documentation, serialization
- domain: apis, documentation, web-development, backend
- platform: python, cross-platform
- tags: openapi, swagger, marshmallow, flask, -schema, spec-generation

## Member repositories
- marshmallow-code/apispec (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:01.769730+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:16:14.013443+00:00, confidence not recorded.
  - readme: https://github.com/marshmallow-code/apispec (fetched 2026-08-28T04:04:01.769730+00:00, sha d330697441a8)
  - registry_pypi: https://pypi.org/pypi/apispec/json (fetched 2026-08-29T12:25:14.525978+00:00, sha 6072443b7246)
- Data as of 2026-08-30T08:39:29.467469+00:00.