ACNH API (v1)

Download OpenAPI specification:Download

A free Animal Crossing: New Horizons API for critters, furniture, villagers and more!

Contact me on Discord: Alexis#8717

The data can be obtained as an object array instead of a nested JSON by doing requests on https://acnhapi.com/v1a/ instead of https://acnhapi.com/v1/

Authentication

Fish

Fish

Get fish data in JSON format.

The {fishID} parameter is optional and can be removed to get all the fish data.

path Parameters
fishID
required
string

Either the file-name of a fish or it's ID.

Responses

200

OK

404

Not Found

get /v1/fish/{fishID}
http://acnhapi.com/v1/fish/{fishID}
https://acnhapi.com/v1/fish/{fishID}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "id": 1,
  • "file-name": "bitterling",
  • "name":
    {
    },
  • "availability":
    {
    },
  • "shadow": "Smallest (1)",
  • "price": 900,
  • "price-cj": 1350,
  • "catch-phrase": "I caught a bitterling! It's mad at me, but only a little.",
  • "museum-phrase": "Bitterlings hide their eggs inside large bivalves—like clams—where the young can stay safe until grown. The bitterling isn't being sneaky. No, their young help keep the bivalve healthy by eating invading parasites! It's a wonderful bit of evolutionary deal making, don't you think? Each one keeping the other safe... Though eating parasites does not sound like a happy childhood... Is that why the fish is so bitter?",
}

Sea Creatures

Sea Creatures

Get sea creature data in JSON format.

The {seaID} parameter is optional and can be removed to get all the sea creature data.

path Parameters
seaID
required
string

Either the file-name of a sea creature or it's ID.

Responses

200

OK

404

Not Found

get /v1/sea/{seaID}
http://acnhapi.com/v1/sea/{seaID}
https://acnhapi.com/v1/sea/{seaID}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "id": 1,
  • "file-name": "seaweed",
  • "name":
    {
    },
  • "availability":
    {
    },
  • "speed": "Stationary",
  • "shadow": "Large",
  • "price": 600,
  • "catch-phrase": "I got some seaweed! I couldn't kelp myself.",
  • "museum-phrase": "Let it be known that seaweed is a misnomer of the highest order! That is, it is not a noxious weed so much as it is a marine algae most beneficial to life on land and sea. Seaweed, you see, provides essential habitat and food for all manner of marine creatures. And it creates a great deal of the oxygen we land lovers love to breath too, hoo! And yet, I can't help but shudder when the slimy stuff touches my toes during a swim. Hoot! The horror!"
}

Bugs

Bugs

Get bugs data in JSON format.

The {bugID} parameter is optional and can be removed to get all the bugs data.

path Parameters
bugID
required
string

Either the file-name of a bug or it's ID.

Responses

200

OK

404

Not Found

get /v1/bugs/{bugID}
http://acnhapi.com/v1/bugs/{bugID}
https://acnhapi.com/v1/bugs/{bugID}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "id": 1,
  • "file-name": "common_butterfly",
  • "name":
    {
    },
  • "availability":
    {
    },
  • "price": 160,
  • "price-flick": 240,
  • "catch-phrase": "I caught a common butterfly! They often flutter by!",
  • "museum-phrase": "The common butterfly would have you believe it is but a beautiful friend flitting prettily about the flowers. Bah, I say! They may seem innocent things with their pretty white wings, but they hide a dark side! The common butterfly caterpillar is called a cabbage worm, you see, and it's a most voracious pest. The ravenous beasts chew through cabbage, broccoli, kale and the like with a devastating gusto. And my feathers! Their green coloring is truly GROSS! A hoo-rrific hue, I say.",
}

Fossils

Fossils

Get fossil data in JSON format.

The {fossilName} parameter is optional and can be removed to get all the fossils data.

path Parameters
fossilName
required
string

The file-name of a fossil.

Responses

200

OK

404

Not Found

get /v1/fossils/{fossilName}
http://acnhapi.com/v1/fossils/{fossilName}
https://acnhapi.com/v1/fossils/{fossilName}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "file-name": "amber",
  • "name":
    {
    },
  • "price": 1200,
  • "museum-phrase": "Amber is formed from the sap of ancient trees that hardened over time. Because of its beauty, it has often been traded and used as jewelry throughout history. However, individual specimens may contain ancient plants or insects trapped inside them! These are valuable resources for learning about ancient eras, such as when the dinosaurs roamed... And this is why they are sometimes displayed in certain...ahem... exceptional museums! Like mine.",
}

Villagers

Villagers

Get villager data in JSON format.

The {villagerID} parameter is optional and can be removed to get all the villagers data.

path Parameters
villagerID
required
string

Either the file-name of a villager or it's ID.

Responses

200

OK

404

Not Found

get /v1/villagers/{villagerID}
http://acnhapi.com/v1/villagers/{villagerID}
https://acnhapi.com/v1/villagers/{villagerID}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "id": 1,
  • "file-name": "ant00",
  • "name":
    {
    },
  • "personality": "Cranky",
  • "birthday-string": "March 9th",
  • "birthday": "9/3",
  • "species": "Anteater",
  • "gender": "Male",
  • "catch-phrase": "ah-CHOO",
}

Icons

Fish icons

Get fish icons in PNG format.

The {fishID} parameter can be found using the /v1/fish/ endpoint.

path Parameters
fishID
required
string

Either the file-name of a fish or it's ID.

Responses

200

OK

404

Not Found

get /v1/icons/fish/{fishID}
http://acnhapi.com/v1/icons/fish/{fishID}
https://acnhapi.com/v1/icons/fish/{fishID}

Bugs icons

Get bugs icons in PNG format.

The {bugID} parameter can be found using the /v1/bugs/ endpoint.

path Parameters
bugID
required
string

Either the file-name of a bug or it's ID.

Responses

200

OK

404

Not Found

get /v1/icons/bugs/{bugID}
http://acnhapi.com/v1/icons/bugs/{bugID}
https://acnhapi.com/v1/icons/bugs/{bugID}

Villager icons

Get villager icons in PNG format.

The {villagerID} parameter can be found using the /v1/villagers/ endpoint.

path Parameters
villagerID
required
string

Either the file-name of a villager or it's ID.

Responses

200

OK

404

Not Found

get /v1/icons/villagers/{villagerID}
http://acnhapi.com/v1/icons/villagers/{villagerID}
https://acnhapi.com/v1/icons/villagers/{villagerID}

Your GET endpoint

Get art icons in PNG format.

The {artID} parameter can be found using the /art/ endpoint.

path Parameters
artID
required
string

Responses

200

OK

404

Not Found

get /v1/icons/art/{artID}
http://acnhapi.com/v1/icons/art/{artID}
https://acnhapi.com/v1/icons/art/{artID}

Images

Fish images

Get fish images in PNG format.

The {fishID} parameter can be found using the /v1/fish/ endpoint.

path Parameters
fishID
required
string

Either the file-name of a fish or it's ID.

Responses

200

OK

404

Not Found

get /v1/images/fish/{fishID}
http://acnhapi.com/v1/images/fish/{fishID}
https://acnhapi.com/v1/images/fish/{fishID}

Bugs images

Get bugs images in PNG format.

The {bugID} parameter can be found using the /v1/bugs/ endpoint.

path Parameters
bugID
required
string

Either the file-name of a bug or it's ID.

Responses

200

OK

404

Not Found

get /v1/images/bugs/{bugID}
http://acnhapi.com/v1/images/bugs/{bugID}
https://acnhapi.com/v1/images/bugs/{bugID}

Villager images

Get villager images in PNG format.

The {villagerID} parameter can be found using the /v1/villagers/ endpoint.

path Parameters
villagerID
required
string

Either the file-name of a villager or it's ID.

Responses

200

OK

404

Not Found

get /v1/images/villagers/{villagerID}
http://acnhapi.com/v1/images/villagers/{villagerID}
https://acnhapi.com/v1/images/villagers/{villagerID}

Fossils images

Get fossil images in PNG format.

The {fossilName} parameter can be found using the /v1/fossils/ endpoint.

path Parameters
fossilName
required
string

The file-name of a fossil.

Responses

200

OK

404

Not Found

get /v1/images/fossils/{fossilName}
http://acnhapi.com/v1/images/fossils/{fossilName}
https://acnhapi.com/v1/images/fossils/{fossilName}

Song images

Get song cover images in PNG format.

The {songID} parameter can be found using the /v1/songs/ endpoint.

path Parameters
songID
required
string

Responses

200

OK

404

Not Found

get /v1/images/songs/{songID}
http://acnhapi.com/v1/images/songs/{songID}
https://acnhapi.com/v1/images/songs/{songID}

Furniture images

Get furniture images in PNG format.

The {furnitureFileName} parameter can be found using the file-name key in an houseware/wallmounted/misc variant object (eg: FtrJewelrystand_Remake_0_0).

path Parameters
furnitureFileName
required
string

Responses

200

OK

404

Not Found

get /v1/images/funiture/{furnitureFileName}
http://acnhapi.com/v1/images/funiture/{furnitureFileName}
https://acnhapi.com/v1/images/funiture/{furnitureFileName}

Songs

Songs

Get K.K. songs data in JSON format.

The {songID} parameter is optional and can be removed to get all the songs data.

path Parameters
songID
required
string

Responses

200

OK

404

Not Found

get /v1/songs/{songID}
http://acnhapi.com/v1/songs/{songID}
https://acnhapi.com/v1/songs/{songID}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "id": 1,
  • "file-name": "mjk_Keiji",