Ron Swanson Quotes

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.

1 APIs 7 Features

EntertainmentTelevisionParks and RecreationQuotesOpen SourcePublic APIsNode.jsTypeScriptHerokuREST

APIs

Ron Swanson Quotes API

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...

Collections

Ron Swanson Quotes API

OPEN

Features

Random Quote

Return a single random Ron Swanson quote as a one-element JSON array.

Batch Random Quotes

Return N random Ron Swanson quotes in a single response via /quotes/{count}.

Full-Text Search

Search the quote corpus for a substring with case-insensitive matching via /quotes/search/{term}; returns every matching quote.

No Authentication

Public endpoint with no API key, OAuth, or signup required.

CORS Enabled

Access-Control-Allow-Origin is set to * so the API can be called directly from any browser-based frontend without a proxy.

Self-Describing OpenAPI 3.0 Schema

Live OpenAPI 3.0 specification served by the API itself at GET /v2/schema, contributed by Chris Gali.

Rate Limit Headers

Standard X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset headers are returned on every response.

Use Cases

API Tutorial Fixture

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.

Voice Assistant Skill

Powers Alexa skills and other voice-assistant demos that deliver a Ron Swanson quote on request.

Chatbot Integration

Supplies the underlying quote source for Hubot, Slack, and Discord bot examples (see hubot-swanson npm package by the same author).

Frontend Demo App

CORS-enabled endpoint makes it suitable for in-browser SPA demos (React, Vue, Svelte) without requiring a backend proxy.

API Client Library Test Target

Stable shape and no auth make it a practical test target for HTTP-client libraries and SDK generators.

Workshop and Conference Demo

Used in conference talks and workshops to illustrate REST, OpenAPI-from-code, and API mocking concepts.

Integrations

Hubot

Official Hubot script (hubot-swanson, by the API author) that pulls quotes into Hubot-powered chatops bots.

Heroku

Service is deployed on the Heroku platform; the production host is ron-swanson-quotes.herokuapp.com.

Alexa Skills

Multiple community-built Amazon Alexa skills consume this API to read Ron Swanson quotes on Echo devices.

Slack and Discord Bots

Used as a quote source by various community chatbots.

PublicAPIsListing

No Authentication Required

Authentication

🔗

Per-Client Rate Limit Headers

RateLimits

📦

Hubot Swanson (npm) - Chatbot Integration by Author

SDKs

💻

Browser JavaScript Demo (JSFiddle)

CodeExamples

🔗

Apache License 2.0

License

🔗

Ron Swanson Quotes Spectral Ruleset

SpectralRules

🔗

Ron Swanson Quotes JSON-LD Context

JSONLD

🔗

Ron Swanson Quotes Vocabulary

Vocabulary

Sources

opencollection: 1.0.0
info:
  name: Ron Swanson Quotes API
  version: 1.0.0
items:
- info:
    name: Quotes
    type: folder
  items:
  - info:
      name: Ron Swanson Quotes Get Random Quote
      type: http
    http:
      method: GET
      url: https://ron-swanson-quotes.herokuapp.com/v2/quotes
    docs: Return a single random Ron Swanson quote wrapped in a one-element JSON array of strings. Equivalent to calling /quotes/1.
  - info:
      name: Ron Swanson Quotes Get Random Quotes
      type: http
    http:
      method: GET
      url: https://ron-swanson-quotes.herokuapp.com/v2/quotes/:count
      params:
      - name: count
        value: ''
        type: path
        description: Number of random quotes to return.
    docs: Return a JSON array of `count` random Ron Swanson quotes. The service does not document an upper bound on `count`;
      reasonable values are in the low tens. Negative or non-integer values yield a single quote.
  - info:
      name: Ron Swanson Quotes Search Quotes
      type: http
    http:
      method: GET
      url: https://ron-swanson-quotes.herokuapp.com/v2/quotes/search/:term
      params:
      - name: term
        value: ''
        type: path
        description: URL-encoded search term. Matched against the quote corpus without case sensitivity. Whole-word matching
          is not enforced - substrings also match.
    docs: Return every Ron Swanson quote whose text contains the URL-escaped `term` substring. Matching is case-insensitive.
      The response is an array of zero or more quote strings; an empty array is returned when no quotes match.
bundled: true

Ron Swanson Quotes

APIs

Ron Swanson Quotes API

Collections

Ron Swanson Quotes API

Features

Use Cases

Integrations

Semantic Vocabularies

Ron Swanson Quotes Context

API Governance Rules

Ron Swanson Quotes API Rules

JSON Structure

Ron Swanson Quotes Quote List Structure

Ron Swanson Quotes Quote Structure

Ron Swanson Quotes Rate Limit Error Structure

Example Payloads

Ron Swanson Quotes Rate Limit Error Example

Resources

Sources