Ron Swanson Quotes

aid: ron-swanson-quotes
name: Ron Swanson Quotes
description: >-
  A community-built, open source HTTP API that returns Ron Swanson quotes from the NBC television series Parks and
  Recreation. Returns one or more quotes per request as a JSON array of strings, with an optional case-insensitive
  full-text search over the quote corpus. The service is a small Node.js / TypeScript Express app authored by James
  Wright and hosted on Heroku.
url: https://github.com/jamesseanwright/ron-swanson-quotes
baseURL: https://ron-swanson-quotes.herokuapp.com/v2
humanURL: https://github.com/jamesseanwright/ron-swanson-quotes#ron-swanson-quotes-api
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-30'
x-source: public-apis/public-apis
x-category: Entertainment
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
x-type: opensource
x-status: deprecated
x-status-reason: >-
  Upstream GitHub repository was archived by the author on 2026-01-19 due to personal time constraints. The
  Heroku-hosted API endpoint (https://ron-swanson-quotes.herokuapp.com/v2/quotes) remains alive and responsive at the
  time of profiling (verified 2026-05-30), but no further code changes will be made and the service has no formal SLA.
  Treat as a community-maintained educational resource: useful for tutorials, learning projects, and demos, but not
  appropriate for production dependencies.
tags:
  - Entertainment
  - Television
  - Parks and Recreation
  - Quotes
  - Open Source
  - Public APIs
  - Node.js
  - TypeScript
  - Heroku
  - REST
apis:
  - name: Ron Swanson Quotes API
    description: >-
      Read-only REST API returning random or searched Ron Swanson quotes as a JSON array of strings. No authentication
      is required. CORS is enabled (Access-Control-Allow-Origin is set to *) so the API can be called directly from
      browsers. Three endpoints are exposed at the /v2/ base path: GET /quotes returns a single random quote, GET
      /quotes/{count} returns N random quotes, and GET /quotes/search/{term} returns every quote that contains the given
      term (case-insensitive).
    humanURL: https://github.com/jamesseanwright/ron-swanson-quotes#ron-swanson-quotes-api
    baseURL: https://ron-swanson-quotes.herokuapp.com/v2
    tags:
      - Entertainment
      - Television
      - Quotes
      - REST
    properties:
      - type: Documentation
        url: https://github.com/jamesseanwright/ron-swanson-quotes#ron-swanson-quotes-api
      - type: OpenAPI
        url: openapi/ron-swanson-quotes-openapi.yml
      - type: APIReference
        url: https://ron-swanson-quotes.herokuapp.com/v2/schema
        title: Live OpenAPI 3.0 Schema Endpoint
      - type: JSONSchema
        url: json-schema/ron-swanson-quotes-quote-schema.json
        title: Quote Schema
      - type: JSONSchema
        url: json-schema/ron-swanson-quotes-quote-list-schema.json
        title: QuoteList Schema
      - type: JSONSchema
        url: json-schema/ron-swanson-quotes-rate-limit-error-schema.json
        title: RateLimitError Schema
      - type: JSONStructure
        url: json-structure/ron-swanson-quotes-quote-structure.json
        title: Quote JSON Structure
      - type: JSONStructure
        url: json-structure/ron-swanson-quotes-quote-list-structure.json
        title: QuoteList JSON Structure
      - type: JSONStructure
        url: json-structure/ron-swanson-quotes-rate-limit-error-structure.json
        title: RateLimitError JSON Structure
      - type: Example
        url: examples/ron-swanson-quotes-quote-example.json
        title: Quote Example
      - type: Example
        url: examples/ron-swanson-quotes-quote-list-example.json
        title: QuoteList Example
      - type: Example
        url: examples/ron-swanson-quotes-rate-limit-error-example.json
        title: RateLimitError Example
common:
  - type: GitHubRepository
    url: https://github.com/jamesseanwright/ron-swanson-quotes
  - type: Documentation
    url: https://github.com/jamesseanwright/ron-swanson-quotes#ron-swanson-quotes-api
  - type: PublicAPIsListing
    url: https://github.com/public-apis/public-apis
  - type: ChangeLog
    url: https://github.com/jamesseanwright/ron-swanson-quotes/blob/master/CHANGELOG.md
  - type: Authentication
    url: https://github.com/jamesseanwright/ron-swanson-quotes#ron-swanson-quotes-api
    title: No Authentication Required
  - type: RateLimits
    url: https://github.com/jamesseanwright/ron-swanson-quotes#ron-swanson-quotes-api
    title: Per-Client Rate Limit Headers
    description: >-
      The service returns standard X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers on each
      response. Observed limit is approximately 10 requests per short rolling window per client.
  - type: SDK
    url: https://github.com/jamesseanwright/hubot-swanson
    title: Hubot Swanson (npm) - Chatbot Integration by Author
  - type: CodeExamples
    url: http://jsfiddle.net/7g2w4dhc/27/
    title: Browser JavaScript Demo (JSFiddle)
  - type: License
    url: https://github.com/jamesseanwright/ron-swanson-quotes/blob/master/LICENCE
    title: Apache License 2.0
  - type: SpectralRules
    url: rules/ron-swanson-quotes-rules.yml
    title: Ron Swanson Quotes Spectral Ruleset
  - type: JSONLD
    url: json-ld/ron-swanson-quotes-context.jsonld
    title: Ron Swanson Quotes JSON-LD Context
  - type: Vocabulary
    url: vocabulary/ron-swanson-quotes-vocabulary.yml
    title: Ron Swanson Quotes Vocabulary
  - type: Features
    data:
      - name: Random Quote
        description: Return a single random Ron Swanson quote as a one-element JSON array.
      - name: Batch Random Quotes
        description: Return N random Ron Swanson quotes in a single response via /quotes/{count}.
      - name: Full-Text Search
        description: >-
          Search the quote corpus for a substring with case-insensitive matching via /quotes/search/{term}; returns
          every matching quote.
      - name: No Authentication
        description: Public endpoint with no API key, OAuth, or signup required.
      - name: CORS Enabled
        description: >-
          Access-Control-Allow-Origin is set to * so the API can be called directly from any browser-based frontend
          without a proxy.
      - name: Self-Describing OpenAPI 3.0 Schema
        description: Live OpenAPI 3.0 specification served by the API itself at GET /v2/schema, contributed by Chris Gali.
      - name: Rate Limit Headers
        description: Standard X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset headers are returned on every response.
  - type: UseCases
    data:
      - name: API Tutorial Fixture
        description: >-
          Widely used in beginner Node.js, JavaScript, and HTTP tutorials and bootcamp coursework as a friendly, no-auth
          public API to learn fetch, async/await, and JSON parsing.
      - name: Voice Assistant Skill
        description: Powers Alexa skills and other voice-assistant demos that deliver a Ron Swanson quote on request.
      - name: Chatbot Integration
        description: >-
          Supplies the underlying quote source for Hubot, Slack, and Discord bot examples (see hubot-swanson npm package
          by the same author).
      - name: Frontend Demo App
        description: >-
          CORS-enabled endpoint makes it suitable for in-browser SPA demos (React, Vue, Svelte) without requiring a
          backend proxy.
      - name: API Client Library Test Target
        description: Stable shape and no auth make it a practical test target for HTTP-client libraries and SDK generators.
      - name: Workshop and Conference Demo
        description: Used in conference talks and workshops to illustrate REST, OpenAPI-from-code, and API mocking concepts.
  - type: Integrations
    data:
      - name: Hubot
        description: Official Hubot script (hubot-swanson, by the API author) that pulls quotes into Hubot-powered chatops bots.
      - name: Heroku
        description: Service is deployed on the Heroku platform; the production host is ron-swanson-quotes.herokuapp.com.
      - name: Alexa Skills
        description: Multiple community-built Amazon Alexa skills consume this API to read Ron Swanson quotes on Echo devices.
      - name: Slack and Discord Bots
        description: Used as a quote source by various community chatbots.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com
upstream:
  - FN: James Wright
    url: https://james.engineering
    github: https://github.com/jamesseanwright