# Fun Generators API API

> Fun Generators API API on Apizie: 6 endpoints (Get a Riddle entry for a given id. Retrieves a riddle question and answer based on the id., Create a random Riddle entry. Same as 'PUT' but can be used when some of the client libraries don't support…, Create a random Riddle entry., Create a random Riddle entry., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ai:fungenerators-riddle/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ai:fungenerators-riddle`
- Category: Artificial Intelligence
- Status: byok
- Source: https://fungenerators.com
- Page: https://apizie.tech/api/ai/fungenerators-riddle
- OpenAPI: https://apizie.tech/api/ai/fungenerators-riddle/openapi.json

Below is the documentation for the API calls. You can try them out right here.

## Endpoints

### Get a Riddle entry for a given id. Retrieves a riddle question and answer based on the id.
`GET https://apizie.tech/v1/ai:fungenerators-riddle/get-riddle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | ID of the riddle to fetch |

### Create a random Riddle entry. Same as 'PUT' but can be used when some of the client libraries don't support…
`POST https://apizie.tech/v1/ai:fungenerators-riddle/post-riddle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| question | string | yes | Riddle Question |
| category | string | yes | Category of the riddle |
| answer | string | yes | Answer(s) to the riddle question |

### Create a random Riddle entry.
`POST https://apizie.tech/v1/ai:fungenerators-riddle/put-riddle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| question | string | yes | Riddle Question |
| category | string | yes | Category of the riddle |
| answer | string | yes | Answer(s) to the riddle question |

### Create a random Riddle entry.
`POST https://apizie.tech/v1/ai:fungenerators-riddle/delete-riddle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Riddle ID |

### Get a random riddle for a given category(optional)
`GET https://apizie.tech/v1/ai:fungenerators-riddle/get-riddle-random` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | no | Category to get the riddle from |

### Search for random riddle which has the text in the query, for a given category(optional).
`GET https://apizie.tech/v1/ai:fungenerators-riddle/get-riddle-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | Text to search for in the riddle |
| category | string | no | Category to get the riddle from |

## Example
```
curl "https://apizie.tech/v1/ai:fungenerators-riddle/get-riddle" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Fun Generators API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ai:fungenerators-riddle/get-riddle with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Fun Generators API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Fun Generators API itself also needs your own key from fungenerators.com.

### Can AI agents use the Fun Generators API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ai:fungenerators-riddle.

### What is the status of the Fun Generators API API?
Needs your own provider key (bring your own key)