The API is free to use without a key. Anonymous requests are rate-limited to 1 req/sec. With an API key you get 100 req/min.

API key

Paste your key to authenticate test requests. Stays in this tab only.

API Reference

Download OpenAPI specification

GET /no

Returns a random creative way to say no. Filter by style or content mode. Get all available styles from /styles and all available modes from /modes.

Query parameters

stylestringoptional

Filter by style. See /styles for all available styles.

modestringoptional

Content mode. See /modes for all available modes. Defaults to safe. WARNING: nsfw and rogue modes contain adult language, not suitable around children or in professional settings. Authentication required for nsfw and rogue.

langstringoptional

Filter by language name. See /languages for all available languages. Defaults to English. Authentication required for non-English languages.

Request

curl https://api.naas.lol/no

Response schema

200A random no

type: object
required:
  - id
  - text
  - style
  - mode
  - language
properties:
  id:
    type: integer
  text:
    type: string
  style:
    type: string
  mode:
    type: string
  language:
    type: string

Response schema

400Unknown style parameter or invalid mode

Response schema

401Authentication required for nsfw/rogue mode

type: object
required:
  - error
properties:
  error:
    type: string

Response schema

429Rate limit exceeded

type: object
required:
  - error
properties:
  error:
    type: string

Response schema

500No data in database

type: object
required:
  - error
properties:
  error:
    type: string

GET /languages

Lists all available languages you can use to filter responses.

Request

curl https://api.naas.lol/languages

Response schema

200All available languages

type: object
required:
  - languages
properties:
  languages:
    type: array
    items:
      type: string

GET /modes

Lists all available content modes. safe is public. WARNING: nsfw and rogue modes contain adult language, keep away from children and professional environments. Authentication required for nsfw and rogue.

Request

curl https://api.naas.lol/modes

Response schema

200All available modes

type: object
required:
  - modes
properties:
  modes:
    type: array
    items:
      type: string

GET /styles

Lists all available styles you can use to filter responses.

Request

curl https://api.naas.lol/styles

Response schema

200All available styles

type: object
required:
  - styles
properties:
  styles:
    type: array
    items:
      type: string

Response schema

429Rate limit exceeded

type: object
required:
  - error
properties:
  error:
    type: string

GET /count

Returns a nested breakdown of nos by language, style, and mode as { language: { style: { mode: count } } }. All parameters are optional — omit all to get the full breakdown, or filter to narrow which keys appear.

Query parameters

languagestringoptional

Filter by language. See /languages for all available languages.

stylestringoptional

Filter by style. See /styles for all available styles.

modestringoptional

Filter by content mode (safe, nsfw, rogue).

Request

curl https://api.naas.lol/count

Response schema

200Count breakdown. Shape is always { language: { style: { mode: count } } }. Params filter which keys appear.

type: object