PHPackages                             apiverve/madlibs - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. apiverve/madlibs

ActiveLibrary[API Development](/categories/api)

apiverve/madlibs
================

Mad Libs Generator creates fill-in-the-blank story templates with prompts for nouns, verbs, adjectives, and more.

00C#

Since Jul 16Pushed 1mo agoCompare

[ Source](https://github.com/apiverve/madlibs-api)[ Packagist](https://packagist.org/packages/apiverve/madlibs)[ RSS](/packages/apiverve-madlibs/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

[Mad Libs Generator API](https://apiverve.com/marketplace/madlibs?utm_source=github&utm_medium=readme)
======================================================================================================

[](#mad-libs-generator-api)

Mad Libs Generator creates fill-in-the-blank story templates with prompts for nouns, verbs, adjectives, and more.

The Mad Libs Generator API provides a simple, reliable way to integrate mad libs generator functionality into your applications. Built for developers who need production-ready mad libs generator capabilities without the complexity of building from scratch.

**[View API Details →](https://apiverve.com/marketplace/madlibs?utm_source=github&utm_medium=readme)**

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)[![API Status](https://camo.githubusercontent.com/15e99b75bf27d82ce61696f6ed2bc677c3dbb56b0902a69b0afa0860c95e3aac/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5374617475732d4163746976652d677265656e2e737667)](https://apiverve.com/marketplace/madlibs?utm_source=github&utm_medium=readme)[![Method](https://camo.githubusercontent.com/a2b7cddd4cb12b1e821f02341ecb69a22571a98b2069d832d9c5f106ea07102a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6574686f642d4745542d626c75652e737667)](#)[![Platform](https://camo.githubusercontent.com/baa862d10fe7a5ffd0d064b1e3d41f4034cf5747a1ef289496ef606b53554456/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f506c6174666f726d2d4d756c74692d2d506c6174666f726d2d6f72616e67652e737667)](#installation)

**Available on:**[![npm](https://camo.githubusercontent.com/60c9e8e39546f97cdc6b7d10d0eb0f29b7ef81ad8a1332eee806680cc80697f3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6e706d2d4342333833373f7374796c653d666c6174266c6f676f3d6e706d266c6f676f436f6c6f723d7768697465)](https://www.npmjs.com/package/@apiverve/madlibs)[![NuGet](https://camo.githubusercontent.com/272fcec5c03b95ec239b9bd3abf7e66481ada718e198ca4a59f41c0b366af6b0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4e754765742d3030343838303f7374796c653d666c6174266c6f676f3d6e75676574266c6f676f436f6c6f723d7768697465)](https://www.nuget.org/packages/APIVerve.API.MadLibsGenerator)[![PyPI](https://camo.githubusercontent.com/4bc6211075d1c11d9c07f962783fee71f5f3cc70e04c4ec9d57d4e761a7dd113/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f507950492d3337373641423f7374796c653d666c6174266c6f676f3d707974686f6e266c6f676f436f6c6f723d7768697465)](https://pypi.org/project/apiverve-madlibs/)[![RubyGems](https://camo.githubusercontent.com/71716e070a00057e5feb5a93d39119c1ce4279183edc35e7384bef3e804b68ab/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5275627947656d732d4539353733463f7374796c653d666c6174266c6f676f3d7275627967656d73266c6f676f436f6c6f723d7768697465)](https://rubygems.org/gems/apiverve_madlibs)[![Packagist](https://camo.githubusercontent.com/5c7bb7fb77c5df98a7cc98b925a011394a30fb20f6d381b951a4e87aa8f03c45/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5061636b61676973742d4632384431413f7374796c653d666c6174266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/apiverve/madlibs)[![Go](https://camo.githubusercontent.com/2c54290f2057e36a55a985ab1cd61b80b4a5a732160a50fcd707b7b6b0086460/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f476f2d3030414444383f7374796c653d666c6174266c6f676f3d676f266c6f676f436f6c6f723d7768697465)](#-go)[![Dart](https://camo.githubusercontent.com/dca235ce2ec52c7dacbbd19ee2d738caf995db81745395b17c9d3b6152d28966/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446172742d3031373543323f7374796c653d666c6174266c6f676f3d64617274266c6f676f436f6c6f723d7768697465)](https://pub.dev/packages/apiverve_madlibs)[![JitPack](https://camo.githubusercontent.com/946962aac9fad35d0daf16fc430fd16553165a78db28c01fa09b656467c33824/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4a69745061636b2d3245374433323f7374796c653d666c6174266c6f676f3d616e64726f6964266c6f676f436f6c6f723d7768697465)](#-android-jitpack)

---

Quick Start
-----------

[](#quick-start)

### Using JavaScript

[](#using-javascript)

```
async function callMadLibsGeneratorAPI() {
    try {
        const response = await fetch('https://api.apiverve.com/v1/madlibs', {
            method: 'GET',
            headers: {
                'x-api-key': 'YOUR_API_KEY_HERE'
            }
        });

        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callMadLibsGeneratorAPI();
```

### Using cURL

[](#using-curl)

```
curl -X GET "https://api.apiverve.com/v1/madlibs" \
  -H "x-api-key: YOUR_API_KEY_HERE"
```

**Get your API key:**

**📁 For more examples, see the [examples folder](./examples/)**

---

Installation
------------

[](#installation)

Choose your preferred programming language:

### 📦 NPM (JavaScript/Node.js)

[](#-npm-javascriptnodejs)

```
npm install @apiverve/madlibs
```

[**View NPM Package →**](https://www.npmjs.com/package/@apiverve/madlibs) | [**Package Code →**](./npm/)

---

### 🔷 NuGet (.NET/C#)

[](#-nuget-netc)

```
dotnet add package APIVerve.API.MadLibsGenerator
```

[**View NuGet Package →**](https://www.nuget.org/packages/APIVerve.API.MadLibsGenerator) | [**Package Code →**](./nuget/)

---

### 🐍 Python (PyPI)

[](#-python-pypi)

```
pip install apiverve-madlibs
```

[**View PyPI Package →**](https://pypi.org/project/apiverve-madlibs/) | [**Package Code →**](./python/)

---

### 💎 Ruby (RubyGems)

[](#-ruby-rubygems)

```
gem install apiverve_madlibs
```

[**View RubyGems Package →**](https://rubygems.org/gems/apiverve_madlibs) | [**Package Code →**](./ruby/)

---

### 🐘 PHP (Packagist)

[](#-php-packagist)

```
composer require apiverve/madlibs
```

[**View Packagist Package →**](https://packagist.org/packages/apiverve/madlibs) | [**Package Code →**](./php/)

---

### 🎯 Dart (pub.dev)

[](#-dart-pubdev)

```
dart pub add apiverve_madlibs
```

[**View pub.dev Package →**](https://pub.dev/packages/apiverve_madlibs) | [**Package Code →**](./dart/)

---

### 🤖 Android (JitPack)

[](#-android-jitpack)

```
implementation 'com.github.apiverve:madlibs-api:1.0.0'
```

[**Package Code →**](./android/)

---

### 🐹 Go

[](#-go)

```
go get github.com/apiverve/madlibs-api/go
```

[**Package Code →**](./go/)

---

Why Use This API?
-----------------

[](#why-use-this-api)

FeatureBenefit**Multi-language SDKs**Native packages for JavaScript, Python, C#, Go, and Android**Simple Integration**Single API key authentication, consistent response format**Production Ready**99.9% uptime SLA, served from 24 global regions**Comprehensive Docs**Full examples, OpenAPI spec, and dedicated support---

Documentation
-------------

[](#documentation)

- 🏠 **API Home:** [Mad Libs Generator API](https://apiverve.com/marketplace/madlibs?utm_source=github&utm_medium=readme)
- 📚 **API Reference:** [docs.apiverve.com/ref/madlibs](https://docs.apiverve.com/ref/madlibs)
- 📖 **OpenAPI Spec:** [openapi.yaml](./openapi.yaml)
- 💡 **Examples:** [examples/](./examples/)

---

What Can You Build?
-------------------

[](#what-can-you-build)

The Mad Libs Generator API is commonly used for:

- **Web Applications** - Add mad libs generator features to your frontend or backend
- **Mobile Apps** - Native SDKs for Android development
- **Automation** - Integrate with n8n, Zapier, or custom workflows
- **SaaS Products** - Enhance your product with mad libs generator capabilities
- **Data Pipelines** - Process and analyze data at scale

---

API Reference
-------------

[](#api-reference)

### Authentication

[](#authentication)

All requests require an API key in the header:

```
x-api-key: YOUR_API_KEY_HERE

```

Get your API key:

### Response Format

[](#response-format)

Every APIVerve endpoint returns the same envelope — check `status`, then read `data`:

```
{
  "status": "ok",
  "error": null,
  "data": { ... }
}
```

### Example Response

[](#example-response)

A real response from the Mad Libs Generator API:

```
{
  "status": "ok",
  "error": null,
  "data": {
    "stories": [
      {
        "title": "Restaurant Disaster",
        "template": "I went to a {adjective} restaurant called The {adjective} {noun}. The waiter was a {adjective} {animal} who kept {verb_ing} on the tables. I ordered {number} {adjective} {plural_noun} with a side of {adjective} {noun}. When the bill came, it said I owed {number} {plural_noun}!",
        "blanks": [
          {
            "id": 1,
            "type": "adjective",
            "label": "Adjective"
          },
          {
            "id": 2,
            "type": "adjective",
            "label": "Adjective"
          },
          {
            "id": 3,
            "type": "noun",
            "label": "Noun"
          },
          {
            "id": 4,
            "type": "adjective",
            "label": "Adjective"
          },
          {
            "id": 5,
            "type": "animal",
            "label": "Animal"
          },
          {
            "id": 6,
            "type": "verb_ing",
            "label": "Verb ending in -ing"
          },
          {
            "id": 7,
            "type": "number",
            "label": "Number"
          },
          {
            "id": 8,
            "type": "adjective",
            "label": "Adjective"
          },
          {
            "id": 9,
            "type": "plural_noun",
            "label": "Plural Noun"
          },
          {
            "id": 10,
            "type": "adjective",
            "label": "Adjective"
          },
          {
            "id": 11,
            "type": "noun",
            "label": "Noun"
          },
          {
            "id": 12,
            "type": "number",
            "label": "Number"
          },
          {
            "id": 13,
            "type": "plural_noun",
            "label": "Plural Noun"
          }
        ],
        "blankCount": 13,
        "category": "funny"
      }
    ],
    "count": 1,
    "category": "funny",
    "html": "Mad Libsbody {font-family: Arial, sans-serif; padding: 20px; max-width: 800px; margin: 0 auto;}h1 {text-align: center; color: #E91E63;}.story-card {background: #fff; border: 2px solid #E91E63; padding: 25px; margin: 25px 0; border-radius: 15px;}.title {font-size: 24px; font-weight: bold; color: #E91E63; margin-bottom: 20px;}.blanks-section {background: #FCE4EC; padding: 20px; border-radius: 10px; margin-bottom: 20px;}.blanks-section h3 {margin-top: 0;}.blank-item {margin: 10px 0; display: flex; align-items: center;}.blank-label {min-width: 50px; font-weight: bold;}.blank-type {color: #666; margin-left: 10px;}.blank-input {flex: 1; padding: 8px; border: 1px solid #E91E63; border-radius: 5px; margin-left: 10px;}.story-template {line-height: 2; font-size: 16px;}.blank-marker {background: #E91E63; color: white; padding: 2px 8px; border-radius: 3px; font-weight: bold;}Mad LibsRestaurant DisasterFill in the blanks:1.Adjective2.Adjective3.Noun4.Adjective5.Animal6.Verb ending in -ing7.Number8.Adjective9.Plural Noun10.Adjective11.Noun12.Number13.Plural NounI went to a 1 restaurant called The 2 3. The waiter was a 4 5 who kept 6 on the tables. I ordered 7 8 9 with a side of 10 11. When the bill came, it said I owed 12 13!",
    "image": {
      "imageName": "25d0dd78-3ad1-4f14-a30f-f8bdd8ebcc33_madlibs.png",
      "format": ".png",
      "downloadURL": "https://storage.googleapis.com/apiverve/APIData/madlibs/25d0dd78-3ad1-4f14-a30f-f8bdd8ebcc33_madlibs.png?GoogleAccessId=635500398038-compute%40developer.gserviceaccount.com&Expires=1766010349&Signature=e4owJidlQu2GZKe1GSuClCNSpOX1UQkxdweeS08IVOxkNscZGNr33BdYhNSG%2BuVIZ2XdEeAc3o2%2BY2hxP01APjgqMgCe4QvHRBgbCLPUiueHaczDJ1m1ZBI41aRaYjM8kdB7M0iYLNhdgqogXTYs9Zc%2FaRj9a6txpLz7fb2YexgG0fXhkcZuGeCb1haQlMTHL1YZbh9zJIKgHSqMhKK3jqhf0stuIDXIWkWdiK6fbP1B2aZkomqwpbx3iQKwbhca8rwFMWjUMRN5fspY%2FRtNbS7kIWaznc07VaBloITlQktm%2FMMojDc6QSanGeegRKealslcO53diZRsdLTZvB3wAQ%3D%3D",
      "expires": 1766010349930
    }
  }
}
```

---

Support &amp; Community
-----------------------

[](#support--community)

- 🏠 **API Home**: [Mad Libs Generator API](https://apiverve.com/marketplace/madlibs?utm_source=github&utm_medium=readme)
- 💬 **Support**:
- 🐛 **Issues**: [GitHub Issues](../../issues)
- 📖 **Documentation**:
- 🌐 **Website**:

---

Contributing
------------

[](#contributing)

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

---

Security
--------

[](#security)

For security concerns, please review our [Security Policy](SECURITY.md).

---

License
-------

[](#license)

This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

---

Acknowledgments
---------------

[](#acknowledgments)

Built with ❤️ by [APIVerve](https://apiverve.com)

Copyright © 2026 APIVerve. All rights reserved.

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance60

Regular maintenance activity

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f4d2e1d9263acab05f6a553dfdd4884a1efb8e6d76bd276a50996b3a41e1d6e5?d=identicon)[APIVerve](/maintainers/APIVerve)

---

Tags

android-libraryapiapivervedotnetgamesjavamadlibsnodejsnpm-packagenuget-packagepythonpython-packagerest-api

### Embed Badge

![Health badge](/badges/apiverve-madlibs/health.svg)

```
[![Health](https://phpackages.com/badges/apiverve-madlibs/health.svg)](https://phpackages.com/packages/apiverve-madlibs)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35916.5M7](/packages/exsyst-swagger)[lucasdotvin/laravel-soulbscription

A straightforward interface to handle subscriptions and features consumption.

710215.3k](/packages/lucasdotvin-laravel-soulbscription)[pimax/fb-messenger-php

Facebook Messenger Bot PHP API

316188.8k2](/packages/pimax-fb-messenger-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
