canonical: https://jentic.com/apis/dodo.ac/nookipedia

# Dodo Ac Nookipedia

The Nookipedia API exposes Animal Crossing game data sourced from the community-maintained Nookipedia wiki, covering villagers, fish, bugs, sea creatures, art, furniture, clothing, tools, items, recipes, and fossils across the series with deep coverage for New Horizons. Endpoints return structured JSON for catalogue browsers, companion apps, museum trackers, and bots. An access key, requested via the Nookipedia form, is required for live calls. The API is an information-only service for fan tools and editorial integrations.

## For AI agents

Look up Animal Crossing villagers, fish, bugs, art, furniture, recipes, and fossils from the Nookipedia wiki via GET endpoints keyed on item names.

## Scope

Does not handle Nintendo account data, save-game uploads, or in-game actions - use for read-only Animal Crossing wiki data only.

## Capabilities

- Look up villager data via GET /villagers
- List New Horizons fish, bugs, and sea creatures with `/nh/fish`, `/nh/bugs`, and `/nh/sea`
- Fetch a single artwork by name via GET `/nh/art/{artwork}`
- Browse New Horizons furniture, clothing, tools, and interior items
- Retrieve DIY recipes through `/nh/recipes` and `/nh/recipes/{item}`
- Look up fossil information via `/nh/fossils/individuals`

## Use cases

### Animal Crossing Companion App Catalogue

Power a companion app that shows villagers, critters, art, and furniture by calling Nookipedia endpoints like /villagers, `/nh/fish`, and `/nh/art.` Each endpoint returns structured wiki-derived JSON, so an app can render searchable lists without scraping HTML. Building a catalogue browser usually takes a day once the API key is approved.

Example prompt: GET `/nh/fish` with month=6 and hemisphere=north, then format the response into a Discord embed listing each fish, location, and shadow size.

### Real vs Fake Art Checker

Build a Redd's art authenticity checker by calling GET `/nh/art/{artwork}` for each artwork name. The endpoint returns the canonical real/fake comparison metadata so a tool can tell players which artworks are forgeries. This is a single GET per artwork and runs entirely client-side once cached.

Example prompt: GET `/nh/art` and cache the catalogue, then for a user-provided artwork name call `/nh/art/{artwork}` and return the real-vs-fake metadata.

### Museum Completion Tracker

Track museum completion by combining `/nh/fish`, `/nh/bugs`, `/nh/sea`, `/nh/art`, and `/nh/fossils/individuals` to build the canonical catchable list, then mark each entry caught or donated in user state. The API is read-only, so progress storage stays in the application.

Example prompt: GET `/nh/fish`, `/nh/bugs`, `/nh/sea`, and `/nh/fossils/individuals` and produce a single combined museum checklist for a user.

### AI Agent Game Helper via Jentic

An AI agent uses Jentic to search for Animal Crossing intents, loads the matching Nookipedia GET endpoint, and answers player questions about villagers, critters, or recipes. The Nookipedia API key is held in your Jentic One instance, so the agent never embeds it in tool prompts.

Example prompt: Search Jentic for 'look up an animal crossing villager', execute GET /villagers with the name filter, and return the personality, species, and birthday.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/villagers` | List or look up villagers |
| GET | `/nh/fish` | All New Horizons fish |
| GET | `/nh/bugs` | All New Horizons bugs |
| GET | `/nh/art/{artwork}` | Single New Horizons artwork by name |
| GET | `/nh/recipes` | All New Horizons recipes |
| GET | `/nh/fossils/individuals` | All New Horizons fossils |

## Key resources

- **Villagers** — Series-wide villager profiles
- **Fish, Bugs, Sea Creatures** — New Horizons critter catalogues with seasonal availability
- **Art and Furniture** — Artwork, furniture, clothing, and interior item data for New Horizons
- **Recipes** — DIY recipes and ingredients in New Horizons
- **Fossils** — Individual fossil entries with completion data

## Why Jentic

- **Setup:** Wiring the Nookipedia API by hand means placing your key in the X-API-KEY header and mapping each New Horizons route before you can pull villager or fish data. Through Jentic you install once, import Nookipedia from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Every Nookipedia operation here is read-only wiki data, so scope by operation: limit the agent to the lookups it needs, such as listing villagers or fetching a fish, and it never reaches beyond read access. You choose which of these read operations are in its set.
- **Credential handling:** Your Nookipedia API key is stored once, encrypted, by your own Jentic One instance and injected at execution time on the X-API-KEY header. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'look up an animal crossing villager' or 'list new horizons fish', and Jentic returns the matching Nookipedia operation with its parameter schema so the agent calls the right endpoint without reading the docs.

## Related APIs

- **Kitsu** — Anime and manga catalogue API
- **RAWG** — Cross-platform video game database
- **Discord** — Chat and bot platform

## FAQ

### What authentication does the Nookipedia API use?

Nookipedia issues per-developer API keys via a request form. Calls include the key in an X-API-KEY header. Through Jentic, the key is stored encrypted in the vault and added to outbound requests at execution time so the agent never sees it.

### Can I look up an Animal Crossing villager with the Nookipedia API?

Yes. GET /villagers returns villager profiles with optional name, species, and personality filters. Use it to render villager cards or answer player questions about a specific resident.

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

The OpenAPI spec does not declare explicit rate limits. Nookipedia operates on a community-supported basis, so cache responses aggressively and apply exponential backoff on 429 errors to avoid pressure on the wiki infrastructure.

### How do I check if an artwork is real or fake through Jentic?

Run pip install jentic and search for 'check animal crossing artwork'. Jentic returns GET `/nh/art/{artwork}.` Execute it with the artwork name and the response indicates the real-vs-fake metadata; the API key is injected from the vault.

### Does the Nookipedia API include New Horizons recipes?

Yes. GET `/nh/recipes` lists every DIY recipe with its ingredients, and GET `/nh/recipes/{item}` returns a single recipe. Pair this with `/nh/items` to resolve any ingredient names you receive back.

### Can I get fossil data for museum completion?

Yes. GET `/nh/fossils/individuals` returns each individual fossil. Combined with `/nh/fish`, `/nh/bugs`, `/nh/sea`, and `/nh/art`, this gives the complete museum catalogue an app needs to track completion.

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

Yes. Because you run Jentic One yourself, your own rules decide which Nookipedia operations the agent may call, and every operation here is read-only wiki data. You can scope the agent to just the lookups it needs, such as GET /villagers to list villagers or GET `/nh/fish` to fetch critters, and leave the rest of the read set out. Since your self-hosted instance holds the X-API-KEY and injects it at execution time, the agent only ever reaches the read endpoints you put in its set.