RandNext Words API
The Words API from RandNext — 3 operation(s) for words.
The Words API from RandNext — 3 operation(s) for words.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/randnext:randnext-words-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: RandNext Words API
version: 1.5.0
description: 'Free random content and generator results from 48 RandNext tools, plus verifiable draw records. No API key needed; only draw management uses the draw''s manage token. Limits: 60 requests/minute and 1,000/day per IP. Free use requires a visible "Powered by RandNext" link to https://randnext.com, and the attribution field must be shown when present.'
servers:
- url: https://randnext.com
tags:
- name: Words
paths:
/api/v1/words/random:
get:
summary: A random word
parameters:
- name: category
in: query
description: Limit results to one content category. Omit it to search every category.
schema:
type: string
enum:
- noun
- verb
- adjective
- adverb
- name: safety
in: query
description: Content safety level. family returns family-safe items only; general also permits general-audience items.
schema:
type: string
enum:
- family
- general
default: general
- name: min_length
in: query
description: Minimum number of letters in the returned word.
schema:
type: integer
default: 1
minimum: 1
maximum: 30
- name: max_length
in: query
description: Maximum number of letters in the returned word.
schema:
type: integer
default: 30
minimum: 1
maximum: 30
- name: starts_with
in: query
description: Return only words beginning with this single letter.
schema:
type: string
responses:
'200':
description: OK
headers:
X-RateLimit-Limit:
schema:
type: integer
X-RateLimit-Remaining:
schema:
type: integer
X-RateLimit-Reset:
schema:
type: integer
description: Unix time (seconds) when the window resets
content:
application/json:
schema:
$ref: '#/components/schemas/Item'
'400':
description: Invalid parameter (INVALID_PARAMETER)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Nothing matches (NOT_FOUND)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limited (RATE_LIMITED)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
headers:
Retry-After:
schema:
type: integer
tags:
- Words
operationId: getApiV1WordsRandom
x-operation-id-source: derived
/api/v1/words:
get:
summary: Several distinct random words
parameters:
- name: category
in: query
description: Limit results to one content category. Omit it to search every category.
schema:
type: string
enum:
- noun
- verb
- adjective
- adverb
- name: safety
in: query
description: Content safety level. family returns family-safe items only; general also permits general-audience items.
schema:
type: string
enum:
- family
- general
default: general
- name: min_length
in: query
description: Minimum number of letters in the returned word.
schema:
type: integer
default: 1
minimum: 1
maximum: 30
- name: max_length
in: query
description: Maximum number of letters in the returned word.
schema:
type: integer
default: 30
minimum: 1
maximum: 30
- name: starts_with
in: query
description: Return only words beginning with this single letter.
schema:
type: string
- name: limit
in: query
description: Number of distinct random items to return.
schema:
type: integer
minimum: 1
maximum: 20
default: 10
responses:
'200':
description: OK
headers:
X-RateLimit-Limit:
schema:
type: integer
X-RateLimit-Remaining:
schema:
type: integer
X-RateLimit-Reset:
schema:
type: integer
description: Unix time (seconds) when the window resets
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Item'
count:
type: integer
'400':
description: Invalid parameter (INVALID_PARAMETER)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Nothing matches (NOT_FOUND)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limited (RATE_LIMITED)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
headers:
Retry-After:
schema:
type: integer
tags:
- Words
operationId: getApiV1Words
x-operation-id-source: derived
/api/v1/words/{id}:
get:
summary: One word by ID
parameters:
- name: id
in: path
required: true
description: Stable ID of the word to retrieve.
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/Item'
'400':
description: Invalid parameter (INVALID_PARAMETER)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Nothing matches (NOT_FOUND)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limited (RATE_LIMITED)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
headers:
Retry-After:
schema:
type: integer
tags:
- Words
operationId: getApiV1WordsById
x-operation-id-source: derived
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- INVALID_PARAMETER
- UNAUTHORIZED
- NOT_FOUND
- CONFLICT
- RATE_LIMITED
- INTERNAL_ERROR
- SERVICE_UNAVAILABLE
message:
type: string
Item:
type: object
required:
- id
- type
- text
- category
- language
- safety_level
- license
- permalink
properties:
id:
type: string
example: jk_000001
type:
type: string
enum:
- joke
- quote
- question
- word
text:
type: string
author:
type:
- string
- 'null'
category:
type: string
tags:
type: array
items:
type: string
language:
type: string
example: en
safety_level:
type: string
enum:
- family
- general
source_url:
type:
- string
- 'null'
license:
type: string
attribution:
type:
- string
- 'null'
description: Must be displayed when not null.
part_of_speech:
type:
- string
- 'null'
description: Words only.
permalink:
type: string
securitySchemes:
manageToken:
type: http
scheme: bearer
description: The manage token returned once when the draw was created.