canonical: https://jentic.com/apis/fungenerators.com/fungenerators-pirate

# Fungenerators Pirates API

The Pirates API generates pirate-themed content on demand. It produces random pirate names, salty pirate insults, pirate-flavoured lorem ipsum filler text, and translates plain English into pirate lingo. The four endpoints make it easy to drop pirate content into novelty sites, holiday campaigns (Talk Like A Pirate Day), games, and chatbots. Auth is a single header API key, and responses are short JSON strings ready to render anywhere a marketing or game team needs a dose of nautical character.

## For AI agents

Generate pirate-themed names, insults, lorem ipsum, and translate English text into pirate lingo.

## Scope

Does not generate audio, images, or non-pirate content - use for pirate-themed text generation and translation only.

## Capabilities

- Generate a random pirate name for characters, mascots, or screen names
- Produce a pirate-style insult for chat replies and game taunts
- Generate pirate-flavoured lorem ipsum filler for design mockups
- Translate plain English text into pirate lingo for novelty content
- Power Talk Like A Pirate Day campaigns with on-demand themed copy

## Use cases

### Talk Like A Pirate Day Campaign

Marketing teams running a Talk Like A Pirate Day campaign need on-brand pirate copy at speed. The Pirates API translates standard English content into pirate lingo, generates pirate names for personalised greetings, and supplies insults for social posts. Integration is a handful of API key calls and the results drop straight into email and social tooling.

Example prompt: Translate the campaign tagline by calling GET `/pirate/translate` with the text query parameter, then schedule the result on social channels.

### Game and App Pirate Content

Indie game studios and novelty apps use the Pirates API to populate NPC names, taunt lines, and procedural lorem ipsum for placeholder UI. The four endpoints together cover the most common pirate-content needs without forcing the team to maintain a custom corpus.

Example prompt: Call GET `/pirate/generate/name` and GET `/pirate/generate/insult` once each to populate an NPC's name and signature taunt.

### Chatbot Pirate Persona

Adding a pirate persona to a chatbot becomes a thin integration when name, insult, and translation operations are available as separate endpoints. The bot can introduce itself with a generated pirate name, translate user prompts into pirate lingo, and lob a themed insult on cue.

Example prompt: On user signup, call GET `/pirate/generate/name` and store the result as the bot's persona name; for replies, call GET `/pirate/translate` with the message text.

### AI Agent Themed Content Tool

Wire the Pirates API into Jentic so any agent can produce pirate-themed names, insults, or translations on request. The agent searches by intent through Jentic, the API key stays vaulted, and the agent receives the structured response as its tool output.

Example prompt: Use Jentic to search 'translate text to pirate lingo', load GET `/pirate/translate`, and execute it with the user's input text.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/pirate/generate/name` | Generate a random pirate name |
| GET | `/pirate/generate/insult` | Generate a random pirate insult |
| GET | `/pirate/generate/lorem-ipsum` | Generate pirate-flavoured lorem ipsum |
| GET | `/pirate/translate` | Translate English text into pirate lingo |

## Key resources

- **Pirate Name** — Generate a random pirate name
- **Pirate Insult** — Generate a pirate-style insult
- **Pirate Lorem Ipsum** — Generate pirate-flavoured filler text
- **Pirate Translate** — Translate plain English to pirate lingo

## Why Jentic

- **Setup:** Wiring the Fungenerators Pirates API by hand means sending an secret-key request header on every call to api.fungenerators.com and mapping the name, insult, lorem-ipsum, and translate routes yourself. Through Jentic you install once, import the Pirates API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The Pirates API takes its input in query parameters rather than a resource path, so you limit the agent to the operations it needs, such as generating a pirate name or translating text to pirate lingo. You choose which operations it may call, and nothing outside that set runs.
- **Credential handling:** Your Fungenerators API key is stored once, encrypted, by your own Jentic One instance and injected into the secret-key request header at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'translate text to pirate lingo' or 'generate a pirate insult', and Jentic returns the matching GET `/pirate/translate` or GET `/pirate/generate/insult` operation with its query parameter schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Shakespeare API** — Same vendor; Shakespearean equivalent of names, insults, lorem ipsum, and translation
- **Taunt as a service** — Same vendor; broader category-based taunts and insults to extend pirate roasts
- **Name Generation API** — Same vendor; supplies non-pirate themed names alongside pirate-only options

## FAQ

### What authentication does the Pirates API use?

It uses an API key supplied in the X-Fungenerators-API-Secret request header. Through Jentic the key is stored encrypted in the vault and attached to outbound calls, so the agent never receives the raw secret.

### Can I translate English text to pirate lingo with this API?

Yes. Call GET `/pirate/translate` and pass the text as a query parameter. The response contains the pirate-styled translation as a string.

### What are the rate limits for the Pirates API?

The OpenAPI spec does not declare explicit rate limits. Fungenerators enforces per-plan quotas listed on the subscription page at fungenerators.com, so consult your plan for per-minute and per-day caps.

### How do I add a pirate persona to my chatbot through Jentic?

Search 'generate a pirate name' or 'translate text to pirate lingo' via the Jentic SDK, load the relevant operation schema (GET `/pirate/generate/name` or GET `/pirate/translate`), and execute it from your bot. Install with pip install jentic.

### Does the Pirates API generate images or audio?

No. It returns text-only responses for names, insults, lorem ipsum, and translations. For audio you would pair it with a separate text-to-speech provider.

### Can I generate pirate insults in bulk?

The insult endpoint returns one result per call. To produce a batch, loop GET `/pirate/generate/insult` N times in your client and de-duplicate on the way in.

### Can I limit what my agent is allowed to do with the Pirates API?

Yes. Jentic One is self-hosted, so your own rules decide which of the four Pirates API operations the agent may call, whether that is GET `/pirate/generate/name`, GET `/pirate/generate/insult`, GET `/pirate/generate/lorem-ipsum`, or GET `/pirate/translate.` You can allow only the operations you need, such as translating text to pirate lingo, and nothing outside that set will run. Because every operation takes its input as a query parameter rather than a resource path, scoping is a straightforward choice of which endpoints and credentials the agent is permitted to use.