AmiAmi API Reference

I have not found AmiAmi API documentation online, so I decided to make my own based on my findings.

URLs

URL	Description
`https://api.amiami.com/api/v1.0`	Base URL for AmiAmi API
`https://img.amiami.com`	The base URL for AmiAmi images; usually you can append the image path returned by the API to this URL to get the full image URL.

Error Codes

Code	Description
`21`	Unknown scode/gcode

Miscellaneous

I think ransu query parameter is for authentication.

Currently dunno the difference between scode and gcode. Both are labeled as "Shop Code".

Categories?

You may get all categories by making a GET request to https://www.amiami.com/js/cate_tag_t.json. They'll probably not change often. But it seems this is not these are not the exact categories used in s_cate3.

[
{  "ersid" : "1",  "cate_tagname_e" : "Figures Categories",  "cate_tagname_c" : "手办"  },
{  "ersid" : "14", "cate_tagname_e" : "Bishoujo Figures",  "cate_tagname_c" : "美少女手办"  },
{  "ersid" : "15", "cate_tagname_e" : "Character Figures",  "cate_tagname_c" : "人物手办"  },
{  "ersid" : "16", "cate_tagname_e" : "Foreign Figures",  "cate_tagname_c" : "海外角色手办（兵人）"  },
{  "ersid" : "2",  "cate_tagname_e" : "Dolls",  "cate_tagname_c" : "娃娃"  },
{  "ersid" : "4",  "cate_tagname_e" : "Gundam Toys",  "cate_tagname_c" : "高达模型"  },
{  "ersid" : "5",  "cate_tagname_e" : "Robots",  "cate_tagname_c" : "机器人"  },
{  "ersid" : "6",  "cate_tagname_e" : "Tokusatsu Toys",  "cate_tagname_c" : "特摄玩具"  },
{  "ersid" : "3",  "cate_tagname_e" : "Scale Models",  "cate_tagname_c" : "比例模型"  },
{  "ersid" : "17", "cate_tagname_e" : "Scale/Military",  "cate_tagname_c" : "军事比例模型"  },
{  "ersid" : "19", "cate_tagname_e" : "Car Models",  "cate_tagname_c" : "车模"  },
{  "ersid" : "21", "cate_tagname_e" : "Train Models",  "cate_tagname_c" : "火车模型"  },
{  "ersid" : "18", "cate_tagname_e" : "Car Plastic Model Kits",  "cate_tagname_c" : "汽车塑料模型"  },
{  "ersid" : "36", "cate_tagname_e" : "Plastic Models",  "cate_tagname_c" : "塑料模型"  },
{  "ersid" : "22", "cate_tagname_e" : "Tools / Paints / Material",  "cate_tagname_c" : "工具 /涂料 / 材料"  },
{  "ersid" : "39", "cate_tagname_e" : "Tools",  "cate_tagname_c" : "工具"  },
{  "ersid" : "40", "cate_tagname_e" : "Paints",  "cate_tagname_c" : "涂料"  },
{  "ersid" : "41", "cate_tagname_e" : "Element",  "cate_tagname_c" : "材料"  },
{  "ersid" : "10", "cate_tagname_e" : "Character Goods",  "cate_tagname_c" : "角色周边"  },
{  "ersid" : "23", "cate_tagname_e" : "Trading Figures",  "cate_tagname_c" : "盒蛋/扭蛋"  },
{  "ersid" : "42", "cate_tagname_e" : "Fashion",  "cate_tagname_c" : "时尚"  },
{  "ersid" : "43", "cate_tagname_e" : "Men's Fashion",  "cate_tagname_c" : "男士时装"  },
{  "ersid" : "44", "cate_tagname_e" : "Ladies' Fashion",  "cate_tagname_c" : "女士时装"  },
{  "ersid" : "45", "cate_tagname_e" : "Cosplay",  "cate_tagname_c" : "角色扮演"  },
{  "ersid" : "8",  "cate_tagname_e" : "Books/Mangas",  "cate_tagname_c" : "书 杂志"  },
{  "ersid" : "9",  "cate_tagname_e" : "Video Games",  "cate_tagname_c" : "主机游戏"  },
{  "ersid" : "7",  "cate_tagname_e" : "Videos & Music",  "cate_tagname_c" : "动画光盘・CD"  },
{  "ersid" : "25", "cate_tagname_e" : "Blu-ray",  "cate_tagname_c" : "蓝光"  },
{  "ersid" : "26", "cate_tagname_e" : "DVDs",  "cate_tagname_c" : "DVD"  },
{  "ersid" : "27", "cate_tagname_e" : "CDs",  "cate_tagname_c" : "CD"  },
{  "ersid" : "11", "cate_tagname_e" : "Trading Cards",  "cate_tagname_c" : "卡片游戏"  },
{  "ersid" : "29", "cate_tagname_e" : "Character Trading Cards",  "cate_tagname_c" : "动漫角色卡片"  },
{  "ersid" : "30", "cate_tagname_e" : "Idols / Talents",  "cate_tagname_c" : "偶像 /艺人交换卡"  },
{  "ersid" : "31", "cate_tagname_e" : "Sports",  "cate_tagname_c" : "运动"  },
{  "ersid" : "28", "cate_tagname_e" : "Card Games",  "cate_tagname_c" : "卡牌游戏"  },
{  "ersid" : "32", "cate_tagname_e" : "Card Holders",  "cate_tagname_c" : "卡套"  },
{  "ersid" : "12", "cate_tagname_e" : "Toys",  "cate_tagname_c" : "玩具"  },
{  "ersid" : "34", "cate_tagname_e" : "Kid's Toys",  "cate_tagname_c" : "儿童玩具"  },
{  "ersid" : "48", "cate_tagname_e" : "Board Games",  "cate_tagname_c" : "棋盘游戏"  },
{  "ersid" : "35", "cate_tagname_e" : "Jigsaw Puzzles",  "cate_tagname_c" : "益智拼图"  },
{  "ersid" : "37", "cate_tagname_e" : "Plush Dolls",  "cate_tagname_c" : "毛绒娃娃"  },
{  "ersid" : "46", "cate_tagname_e" : "Household Goods",  "cate_tagname_c" : "家庭用品"  },
{  "ersid" : "38", "cate_tagname_e" : "Stationery",  "cate_tagname_c" : "文具"  },
{  "ersid" : "47", "cate_tagname_e" : "Sports / Outdoors",  "cate_tagname_c" : "运动的・户外用品"  },
{  "ersid" : "33", "cate_tagname_e" : "Calendars",  "cate_tagname_c" : "日历"  },
{  "ersid" : "13", "cate_tagname_e" : "Age Restricted Products",  "cate_tagname_c" : "成人商品"  }
]

Extracted categories

Here are extracted categories from their static page.

{ "bishoujo": { "name": "Bishoujo Figures", "icon": "https://img.amiami.com/images/genre/icon/1001.png", "url": "/eng/c/bishoujo/", "s_cate3": { "9713": "Completed Figures", "1202": "Nendoroid", "1209": "figma", "9709": "Plastic Kit / Plastic Models", "1123": "Action Figures", "9711": "Garage Kits" } }, "characterfigure": { "name": "Character Figures", "icon": "https://img.amiami.com/images/genre/icon/1002.png", "url": "/eng/c/characterfigure/", "s_cate3": { "10080": "Action Figures", "9726": "Completed Figures", "1223": "Nendoroid (General)", "9723": "figma", "9722": "Plastic Kit / Plastic Models", "1033": "Garage Kits", "9728": "Scenery Set/Accessories", "1212": "Others" } }, "foreignfigure": { "name": "Foreign Figures", "icon": "https://img.amiami.com/images/genre/icon/1003.png", "url": "/eng/c/foreignfigure/", "s_cate3": { "9727": "Military Action Figures", "1094": "TV Series", "8510": "Video Game Characters", "1110": "Other Anime Titles", "1101": "Other American Comics", "1108": "Other Movies", "1102": "Musicians/Celebrities", "1084": "Alien/Predator", "1086": "Star Wars", "1090": "Star Trek", "1096": "X-MEN", "1097": "Spider-Man", "1099": "Batman", "9731": "Iron Man", "1366": "Other Genres" } }, "dolls": { "name": "Dolls", "icon": "https://img.amiami.com/images/genre/icon/1004.png", "url": "/eng/c/dolls/", "s_cate3": { "9626": "Furniture", "41": "Azone", "1042": "Pullip", "1043": "Blythe", "1367": "momoko DOLL", "46": "CUTIES", "1461": "Display Stands", "1041": "Non-Character Bodies", "1044": "Other Character Bodies", "1329": "Foreign Manufacturers", "1312": "Other Character Dolls", "48": "Other Groove Companies", "9744": "Tokyo Doll" } }, "gundam": { "name": "Gundam Toys", "icon": "https://img.amiami.com/images/genre/icon/2001.png", "url": "/eng/c/gundam/", "s_cate4": { "10100": "Action Figures", "938": "Plastic Model Kits", "942": "Other" } }, "robots": { "name": "Robots", "icon": "https://img.amiami.com/images/genre/icon/2002.png", "url": "/eng/c/robots/", "s_cate4": { "9687": "Plastic Models (Main Body)", "9721": "Plastic Models (Option Parts)", "9688": "Complete Figures", "1005": "Garage Kits" } }, "tokusatsu": { "name": "Tokusatsu Toys", "icon": "https://img.amiami.com/images/genre/icon/2003.png", "url": "/eng/c/tokusatsu/", "s_cate4": { "971": "Figures", "969": "Sentai Series", "976": "Kamen (Masked) Rider", "953": "Ultraman", "968": "Godzilla/Gamera, etc.", "9725": "Action Figures", "984": "Other" } }, "scale": { "name": "Scale/Military", "icon": "https://img.amiami.com/images/genre/icon/3001.png", "url": "/eng/c/scale/", "s_cate3": { "8488": "Plastic Model Kits", "945": "Radio Control", "950": "Wooden Models", "8489": "Other Completed Models", "973": "Sci-Fi Movies" } }, "carmodels": { "name": "Car Models", "icon": "https://img.amiami.com/images/genre/icon/3003.png", "url": "/eng/c/carmodels/", "s_cate3": { "947": "Choro-Q", "9921": "TOMICA", "9923": "TOMICA Limited", "9932": "KYOSHO", "9935": "GOOD SMILE RACING", "9917": "Wit's", "9919": "EBBRO", "9925": "RAI'S", "9930": "Spark", "9931": "ixo", "9934": "WELLY", "9918": "GREENLIGHT", "9920": "AUTOart", "9924": "Interallied", "9933": "Make Up", "9936": "Slot Cars", "9927": "Motorcycle Models", "9928": "Others" } }, "trainmodels": { "name": "Train Models", "icon": "https://img.amiami.com/images/genre/icon/3005.png", "url": "/eng/c/trainmodels/", "s_cate3": { "9806": "Other sizes", "9792": "N Gauge", "9817": "HO/16.5mm", "9805": "Z Gauge", "9832": "Train Toys", "9808": "Structures", "9881": "Scenery", "9829": "Other Goods", "9841": "Books", "9815": "Tools", "9816": "Others" } }, "tools": { "name": "Tools / Paints / Material", "icon": "https://img.amiami.com/images/genre/icon/3006.png", "url": "/eng/c/tools/", "s_cate3": { "9592": "Paints / Solvent", "9566": "Painting Tools", "9590": "Adhesives / Putty", "9588": "Polishing", "9576": "Craft Tools", "9585": "Material", "9571": "Decal", "10138": "Other" } }, "carplasticmodel": { "name": "Car Plastic Model Kits", "icon": "https://img.amiami.com/images/genre/icon/3002.png", "url": "/eng/c/carplasticmodel/", "s_cate3": {} }, "tradingfigure": { "name": "Trading Figures", "icon": "https://img.amiami.com/images/genre/icon/4001.png", "url": "/eng/c/tradingfigure/", "s_cate2": { "230": "Bishoujo", "397": "General", "398": "Tokusatsu (SFX) / Live Action", "405": "Robots", "403": "Family Characters", "399": "Miniatures", "611": "Talents / Sports", "401": "Vehicles, Military", "406": "Animals", "407": "Other" } }, "charactergoods": { "name": "Character Goods", "icon": "https://img.amiami.com/images/genre/icon/4002.png", "url": "/eng/c/charactergoods/?tab=1", "s_cate2": { "413": "Bishoujo", "414": "Anime", "1462": "Robot Anime", "639": "Games", "418": "Tokusatsu (SFX)", "415": "Family Characters", "185": "Hugging Pillows / Cushions", "10037": "Prepaid Cards", "417": "Movies / Talents", "8516": "History / Sengoku Era", "416": "Other" } }, "plush": { "name": "Plush Dolls", "icon": "https://img.amiami.com/images/genre/icon/8001.png", "url": "/eng/c/plush/", "s_cate2": {} }, "fashion": { "name": "Fashion", "icon": "https://img.amiami.com/images/genre/icon/1004.png", "url": "/eng/c/fashion/", "s_cate2": { "9902": "Men's Fashion", "9883": "Ladies' Fashion", "508": "Cosplay Goods", "9890": "Goods", "9897": "Accessories" } }, "books": { "name": "Books/Mangas", "icon": "https://img.amiami.com/images/genre/icon/5001.png", "url": "/eng/c/books/", "s_cate3": { "204": "Manga (single volume)", "9836": "Novels", "193": "Artbooks", "203": "Idols Photobooks", "158": "Anime Magazines / Mooks", "165": "Figure / Hobby Magazines", "223": "Other Magazines", "205": "Game Guidebooks", "160": "Card Games", "167": "TRPG", "166": "Other Books" } }, "videogames": { "name": "Video Games", "icon": "https://img.amiami.com/images/genre/icon/5002.png", "url": "/eng/c/videogames/", "s_cate3": { "10054": "Nintendo Switch", "10146": "Nintendo Switch 2", "9772": "PlayStation 4", "10108": "PlayStation 5", "9730": "PS Vita", "9748": "Nintendo Wii U", "9676": "Nintendo 3DS", "1450": "PlayStation 3", "1412": "PSP", "9868": "Xbox One", "10120": "Xbox Series X|S", "1446": "Nintendo Wii", "1349": "Nintendo DS", "1445": "Xbox 360", "1404": "PlayStation 2", "10035": "Prepaid Cards", "159": "PC Games (General)", "164": "Other" } }, "blu-ray": { "name": "Blu-ray Discs", "icon": "https://img.amiami.com/images/genre/icon/6002.png", "url": "/eng/c/blu-ray/", "s_cate3": { "9997": "Anime", "10006": "Tokusatsu (SFX)", "10008": "Japanese Films", "10009": "Foreign Films", "10005": "Female Idols", "10004": "Other" } }, "media": { "name": "DVDs", "icon": "https://img.amiami.com/images/genre/icon/6001.png", "url": "/eng/c/media/", "s_cate3": { "1373": "Anime", "1392": "Tokusatsu (SFX)", "1397": "Japanese Films", "1374": "Foreign Films", "1403": "Female Idols", "1382": "Other" } }, "cd": { "name": "CDs", "icon": "https://img.amiami.com/images/genre/icon/6003.png", "url": "/eng/c/cd/", "s_cate3": { "8472": "Anime / Manga", "8475": "Games", "8473": "Tokusatsu (SFX)", "8477": "Voice Actresses / Artists (Female)", "8511": "Voice Actors / Artists (Male)", "8476": "Other" } }, "cardgames": { "name": "Card Games", "icon": "https://img.amiami.com/images/genre/icon/7001.png", "url": "/eng/c/cardgames/", "s_cate2": { "83": "Yu-Gi-Oh!OCG", "86": "Pokemon Card Game", "113": "Magic: The Gathering", "30": "Weiss Schwarz", "33": "Battle Spirits", "904": "Lycee", "54": "Duel Masters", "9733": "Cardfight!! Vanguard", "10105": "Future Card Buddyfight", "9672": "Precious Memories", "10013": "WIXOSS TCG", "10106": "Z/X -Zillions of enemy X-", "10107": "TCG Fire Emblem Cipher", "1325": "Monster Collection TCG", "9674": "Arcade Card Related", "1114": "Other", "10041": "Single Cards" } }, "tradingcard": { "name": "Trading Cards", "icon": "https://img.amiami.com/images/genre/icon/7002.png", "url": "/eng/c/tradingcard/", "s_cate2": { "136": "Character Trading Cards", "131": "Sports", "121": "Idols / Talents", "215": "Supplies (Card Holders / Tools)" } }, "cardsupply": { "name": "Card Supplies", "icon": "https://img.amiami.com/images/genre/icon/7003.png", "url": "/eng/c/cardsupply/", "s_cate3": { "10099": "Play Mat", "910": "Sleeves", "916": "Deck Cases", "909": "Storage Boxes", "216": "Binders", "907": "Others" } }, "kidstoy": { "name": "Kid's Toys", "icon": "https://img.amiami.com/images/genre/icon/8001.png", "url": "/eng/c/kidstoy/", "s_cate3": { "10118": "Plush Dolls", "8495": "Boys Toys", "8507": "Varieties / Gadgets", "176": "Playing Cards / Board Games", "1467": "Magic Tricks", "1332": "Toy Guns", "9952": "Cap gun", "10104": "Science Kits", "8505": "Educational Toys", "1032": "Other" } }, "householdgoods": { "name": "Household Goods", "icon": "https://img.amiami.com/images/genre/icon/8001.png", "url": "/eng/c/householdgoods/", "s_cate2": { "10042": "Calendars", "10119": "Stationery", "92": "Miscellaneous goods", "10020": "Kitchen tools", "1087": "Sports / Outdoors", "10036": "Food & Drink", "10101": "Bath supplies / Toiletry goods" } }, "stationery": { "name": "Stationery", "icon": "https://img.amiami.com/images/genre/icon/5001.png", "url": "/eng/c/stationery/", "s_cate3": {} }, "boardgames": { "name": "Board Games", "icon": "https://img.amiami.com/images/genre/icon/7001.png", "url": "/eng/c/boardgames/", "s_cate3": {} }, "jigsaw": { "name": "Jigsaw Puzzles", "icon": "https://img.amiami.com/images/genre/icon/8002.png", "url": "/eng/c/jigsaw/", "s_cate3": { "232": "Anime / Characters", "235": "Talents", "243": "Pets & Animals", "1293": "Sceneries", "201": "Art", "248": "Frames", "1335": "Other" } }, "calendar": { "name": "Calendars", "icon": "https://img.amiami.com/images/genre/icon/4003.png", "url": "/eng/c/calendar/", "s_cate3": {} }, "toys": { "name": "Toys", "icon": "https://img.amiami.com/images/genre/icon/.png", "url": "", "s_cate2": { "979": "Arsenal Toys", "1301": "Robots / Tokusatsu (SFX)", "172": "Play Blocks", "8500": "Cooking Toys", "10142": "Children's doll", "10143": "Children's cosmetics", "10144": "Sports & Action Toys", "1299": "General Toys", "200": "Jigsaw Puzzles" } }, "mature": { "name": "Age Restricted Products", "icon": "https://img.amiami.com/images/genre/icon/9000.png", "url": "/eng/c/mature/", "tabs": { "1": "Figures", "2": "Character Goods", "4": "DVDs & Blu-ray Discs", "3": "Video Games" } } }

Category	Icon URL	Category identifier	Sub categories
Bishoujo Figures (`bishoujo`)	`/images/genre/icon/1001.png`	`s_cate3`	`9713`: Completed Figures `1202`: Nendoroid `1209`: figma `9709`: Plastic Kit / Plastic Models `1123`: Action Figures `9711`: Garage Kits
Character Figures (`characterfigure`)	`/images/genre/icon/1002.png`	`s_cate3`	`10080`: Action Figures `9726`: Completed Figures `1223`: Nendoroid (General) `9723`: figma `9722`: Plastic Kit / Plastic Models `1033`: Garage Kits `9728`: Scenery Set/Accessories `1212`: Others
Foreign Figures (`foreignfigure`)	`/images/genre/icon/1003.png`	`s_cate3`	`9727`: Military Action Figures `1094`: TV Series `8510`: Video Game Characters `1110`: Other Anime Titles `1101`: Other American Comics `1108`: Other Movies `1102`: Musicians/Celebrities `1084`: Alien/Predator `1086`: Star Wars `1090`: Star Trek `1096`: X-MEN `1097`: Spider-Man `1099`: Batman `9731`: Iron Man `1366`: Other Genres
Dolls (`dolls`)	`/images/genre/icon/1004.png`	`s_cate3`	`9626`: Furniture `41`: Azone `1042`: Pullip `1043`: Blythe `1367`: momoko DOLL `46`: CUTIES `1461`: Display Stands `1041`: Non-Character Bodies `1044`: Other Character Bodies `1329`: Foreign Manufacturers `1312`: Other Character Dolls `48`: Other Groove Companies `9744`: Tokyo Doll
Gundam Toys (`gundam`)	`/images/genre/icon/2001.png`	`s_cate4`	`10100`: Action Figures `938`: Plastic Model Kits `942`: Other
Robots (`robots`)	`/images/genre/icon/2002.png`	`s_cate4`	`9687`: Plastic Models (Main Body) `9721`: Plastic Models (Option Parts) `9688`: Complete Figures `1005`: Garage Kits
Tokusatsu Toys (`tokusatsu`)	`/images/genre/icon/2003.png`	`s_cate4`	`971`: Figures `969`: Sentai Series `976`: Kamen (Masked) Rider `953`: Ultraman `968`: Godzilla/Gamera, etc. `9725`: Action Figures `984`: Other
Scale/Military (`scale`)	`/images/genre/icon/3001.png`	`s_cate3`	`8488`: Plastic Model Kits `945`: Radio Control `950`: Wooden Models `8489`: Other Completed Models `973`: Sci-Fi Movies
Car Models (`carmodels`)	`/images/genre/icon/3003.png`	`s_cate3`	`947`: Choro-Q `9921`: TOMICA `9923`: TOMICA Limited `9932`: KYOSHO `9935`: GOOD SMILE RACING `9917`: Wit's `9919`: EBBRO `9925`: RAI'S `9930`: Spark `9931`: ixo `9934`: WELLY `9918`: GREENLIGHT `9920`: AUTOart `9924`: Interallied `9933`: Make Up `9936`: Slot Cars `9927`: Motorcycle Models `9928`: Others
Train Models (`trainmodels`)	`/images/genre/icon/3005.png`	`s_cate3`	`9806`: Other sizes `9792`: N Gauge `9817`: HO/16.5mm `9805`: Z Gauge `9832`: Train Toys `9808`: Structures `9881`: Scenery `9829`: Other Goods `9841`: Books `9815`: Tools `9816`: Others
Tools / Paints / Material (`tools`)	`/images/genre/icon/3006.png`	`s_cate3`	`9592`: Paints / Solvent `9566`: Painting Tools `9590`: Adhesives / Putty `9588`: Polishing `9576`: Craft Tools `9585`: Material `9571`: Decal `10138`: Other
Car Plastic Model Kits (`carplasticmodel`)	`/images/genre/icon/3002.png`	N/A	None
Trading Figures (`tradingfigure`)	`/images/genre/icon/4001.png`	`s_cate2`	`230`: Bishoujo `397`: General `398`: Tokusatsu (SFX) / Live Action `405`: Robots `403`: Family Characters `399`: Miniatures `611`: Talents / Sports `401`: Vehicles, Military `406`: Animals `407`: Other
Character Goods (`charactergoods`)	`/images/genre/icon/4002.png`	`s_cate2`	`413`: Bishoujo `414`: Anime `1462`: Robot Anime `639`: Games `418`: Tokusatsu (SFX) `415`: Family Characters `185`: Hugging Pillows / Cushions `10037`: Prepaid Cards `417`: Movies / Talents `8516`: History / Sengoku Era `416`: Other
Plush Dolls (`plush`)	`/images/genre/icon/8001.png`	N/A	None
Fashion (`fashion`)	`/images/genre/icon/1004.png`	`s_cate2`	`9902`: Men's Fashion `9883`: Ladies' Fashion `508`: Cosplay Goods `9890`: Goods `9897`: Accessories
Books/Mangas (`books`)	`/images/genre/icon/5001.png`	`s_cate3`	`204`: Manga (single volume) `9836`: Novels `193`: Artbooks `203`: Idols Photobooks `158`: Anime Magazines / Mooks `165`: Figure / Hobby Magazines `223`: Other Magazines `205`: Game Guidebooks `160`: Card Games `167`: TRPG `166`: Other Books
Video Games (`videogames`)	`/images/genre/icon/5002.png`	`s_cate3`	`10054`: Nintendo Switch `10146`: Nintendo Switch 2 `9772`: PlayStation 4 `10108`: PlayStation 5 `9730`: PS Vita `9748`: Nintendo Wii U `9676`: Nintendo 3DS `1450`: PlayStation 3 `1412`: PSP `9868`: Xbox One `10120`: Xbox Series X\\|S `1446`: Nintendo Wii `1349`: Nintendo DS `1445`: Xbox 360 `1404`: PlayStation 2 `10035`: Prepaid Cards `159`: PC Games (General) `164`: Other
Blu-ray Discs (`blu-ray`)	`/images/genre/icon/6002.png`	`s_cate3`	`9997`: Anime `10006`: Tokusatsu (SFX) `10008`: Japanese Films `10009`: Foreign Films `10005`: Female Idols `10004`: Other
DVDs (`media`)	`/images/genre/icon/6001.png`	`s_cate3`	`1373`: Anime `1392`: Tokusatsu (SFX) `1397`: Japanese Films `1374`: Foreign Films `1403`: Female Idols `1382`: Other
CDs (`cd`)	`/images/genre/icon/6003.png`	`s_cate3`	`8472`: Anime / Manga `8475`: Games `8473`: Tokusatsu (SFX) `8477`: Voice Actresses / Artists (Female) `8511`: Voice Actors / Artists (Male) `8476`: Other
Card Games (`cardgames`)	`/images/genre/icon/7001.png`	`s_cate2`	`83`: Yu-Gi-Oh!OCG `86`: Pokemon Card Game `113`: Magic: The Gathering `30`: Weiss Schwarz `33`: Battle Spirits `904`: Lycee `54`: Duel Masters `9733`: Cardfight!! Vanguard `10105`: Future Card Buddyfight `9672`: Precious Memories `10013`: WIXOSS TCG `10106`: Z/X -Zillions of enemy X- `10107`: TCG Fire Emblem Cipher `1325`: Monster Collection TCG `9674`: Arcade Card Related `1114`: Other `10041`: Single Cards
Trading Cards (`tradingcard`)	`/images/genre/icon/7002.png`	`s_cate2`	`136`: Character Trading Cards `131`: Sports `121`: Idols / Talents `215`: Supplies (Card Holders / Tools)
Card Supplies (`cardsupply`)	`/images/genre/icon/7003.png`	`s_cate3`	`10099`: Play Mat `910`: Sleeves `916`: Deck Cases `909`: Storage Boxes `216`: Binders `907`: Others
Kid's Toys (`kidstoy`)	`/images/genre/icon/8001.png`	`s_cate3`	`10118`: Plush Dolls `8495`: Boys Toys `8507`: Varieties / Gadgets `176`: Playing Cards / Board Games `1467`: Magic Tricks `1332`: Toy Guns `9952`: Cap gun `10104`: Science Kits `8505`: Educational Toys `1032`: Other
Household Goods (`householdgoods`)	`/images/genre/icon/8001.png`	`s_cate2`	`10042`: Calendars `10119`: Stationery `92`: Miscellaneous goods `10020`: Kitchen tools `1087`: Sports / Outdoors `10036`: Food & Drink `10101`: Bath supplies / Toiletry goods
Stationery (`stationery`)	`/images/genre/icon/5001.png`	N/A	None
Board Games (`boardgames`)	`/images/genre/icon/7001.png`	N/A	None
Jigsaw Puzzles (`jigsaw`)	`/images/genre/icon/8002.png`	`s_cate3`	`232`: Anime / Characters `235`: Talents `243`: Pets & Animals `1293`: Sceneries `201`: Art `248`: Frames `1335`: Other
Calendars (`calendar`)	`/images/genre/icon/4003.png`	N/A	None
Toys (`toys`)	`/images/genre/icon/.png`	`s_cate2`	`979`: Arsenal Toys `1301`: Robots / Tokusatsu (SFX) `172`: Play Blocks `8500`: Cooking Toys `10142`: Children's doll `10143`: Children's cosmetics `10144`: Sports & Action Toys `1299`: General Toys `200`: Jigsaw Puzzles
Age Restricted Products (`mature`)	`/images/genre/icon/9000.png`	`tabs`	`1`: Figures `2`: Character Goods `4`: DVDs & Blu-ray Discs `3`: Video Games

Character Names

I don't see any list of character names in their API. So I guess I will find some my favorite characters and list them here later.

/items GET

/items

Searches thru AmiAmi's item database. Prices are in JPY!

Request parameters

Responses

{
  "RSuccess": "true",
  "RValue": null,
  "RMessage": "OK",
  "search_result": {
    "total_results": 32
  },
  "items": [
    {
      "gcode": "CGD-9540",
      "gname": "Touhou Plushie Series EX3 Cirno Deka Fumo Cirno (Single Shipment)",
      "thumb_url": "/images/product/main/102/CGD-9540.jpg",
      "thumb_alt": "CGD-9540.jpg",
      "thumb_title": "Touhou Plushie Series EX3 Cirno Deka Fumo Cirno (Single Shipment)",
      "min_price": 29800,
      "max_price": 29800,
      "c_price_taxed": 29800,
      "maker_name": "Gift",
      "saleitem": 0,
      "condition_flg": 0,
      "list_preorder_available": 0,
      "list_backorder_available": 0,
      "list_store_bonus": 0,
      "list_amiami_limited": 0,
      "instock_flg": 0,
      "order_closed_flg": 1,
      "element_id": null,
      "salestatus": "Sold out",
      "salestatus_detail": null,
      "releasedate": null,
      "jancode": null,
      "preorderitem": 0,
      "saletopitem": 0,
      "resale_flg": 1,
      "preowned_sale_flg": 0,
      "for_women_flg": 0,
      "genre_moe": 1,
      "cate6": null,
      "cate7": null,
      "buy_flg": 0,
      "buy_price": 0,
      "buy_remarks": null,
      "stock_flg": 1,
      "image_on": 1,
      "image_category": "102/",
      "image_name": "CGD-9540",
      "metaalt": null
    }
  ],
  "_embedded": {
    "category_tags": [
      {
        "id": 10,
        "name": "Character Goods",
        "count": 24
      }
    ],
    "makers": null,
    "series_titles": null,
    "original_titles": null,
    "character_names": null,
    "elements": null
  }
}

{
  "RSuccess": "false",
  "RValue": {
    "Error": [
      {
        "RequiredParameter": "pagemax",
        "ErrorMessage": "pagemax is required.",
        "ErrorCode": "10000",
        "Fields": [
          [
            "pagemax"
          ]
        ]
      }
    ]
  },
  "RMessage": "Invalid Request pagemax is required."
}

/item GET

/item

Get detailed information about a specific item using its gcode. Prices are in JPY!

Request parameters

Responses

{
  "RSuccess": "true",
  "RValue": null,
  "RMessage": "OK",
  "item": {
    "gcode": "GOODS-04499125",
    "scode": "GOODS-04499125",
    "gname": "Touhou Project Plush Series Aya Shameimaru FumoFumo Aya. (Medium Size)",
    "sname": "Touhou Project Plush Series Aya Shameimaru FumoFumo Aya. (Medium Size)(Released)",
    "gname_sub": "example",
    "sname_simple": "Touhou Project Plush Series Aya Shameimaru FumoFumo Aya. (Medium Size)",
    "sname_simple_j": "東方Project ぬいぐるみシリーズ 射命丸文 ふもふもあや。(まんなかさいず)",
    "main_image_url": "/images/product/main/244/GOODS-04499125.jpg",
    "main_image_alt": "GOODS-04499125.jpg",
    "main_image_title": "Touhou Project Plush Series Aya Shameimaru FumoFumo Aya. (Medium Size) [Gift]",
    "image_comment": "*Actual product may differ from photos. ",
    "youtube": null,
    "list_price": 16000,
    "c_price_taxed": 17600,
    "price": 17600,
    "point": 176,
    "salestatus": "Released",
    "releasedate": "Jun-2025",
    "period_from": null,
    "period_to": null,
    "cart_type": 4,
    "max_cartin_count": 3,
    "include_instock_only_flg": 0,
    "remarks": "*This product cannot be shipped to the following area: Japan",
    "size_info": null,
    "watch_list_available": 1,
    "jancode": "4580731042914",
    "maker_name": "Gift",
    "modeler": "example",
    "modelergroup": "example",
    "spec": "Size: Approx. H40cm (in sitting pose)",
    "memo": "example",
    "copyright": "上海アリス幻樂団",
    "saleitem": 0,
    "condition_flg": 0,
    "preorderitem": 0,
    "backorderitem": 0,
    "store_bonus": 0,
    "amiami_limited": 0,
    "instock_flg": 0,
    "order_closed_flg": 0,
    "preown_attention": 0,
    "producttypeattention": 0,
    "agelimit": 0,
    "customs_warning_flg": 0,
    "preorderattention": "example",
    "preorder_bonus_flg": 0,
    "domesticitem": 0,
    "metadescription": "example",
    "metawords": "example",
    "releasechange_text": "example",
    "cate1": [
      [
        168
      ]
    ],
    "cate2": [
      [
        1299
      ]
    ],
    "cate3": [
      [
        10118
      ]
    ],
    "cate4": null,
    "cate5": null,
    "cate6": null,
    "cate7": null,
    "salestalk": "example",
    "buy_flg": 0,
    "buy_price": 0,
    "buy_remarks": null,
    "end_flg": 0,
    "disp_flg": 0,
    "onsale_flg": 1,
    "handling_store": null,
    "salestatus_detail": "example",
    "stock": 0,
    "newitem": 1,
    "saletopitem": 0,
    "resale_flg": 0,
    "preowned_sale_flg": 0,
    "big_title_flg": 0,
    "soldout_flg": 1,
    "inc_txt1": 0,
    "inc_txt2": 34,
    "inc_txt3": 18,
    "inc_txt4": 34,
    "inc_txt5": 0,
    "inc_txt6": 0,
    "inc_txt7": 0,
    "inc_txt8": 0,
    "inc_txt9": 0,
    "inc_txt10": 0,
    "image_on": 1,
    "image_category": "244/",
    "image_name": "GOODS-04499125",
    "metaalt": "example",
    "image_reviewnumber": 2,
    "image_reviewcategory": "244/",
    "price1": 17600,
    "price2": 0,
    "price3": 0,
    "price4": 0,
    "price5": 17600,
    "discountrate1": 0,
    "discountrate2": 0,
    "discountrate3": 0,
    "discountrate4": 0,
    "discountrate5": 0,
    "sizew": "",
    "colorw": "17,600JPY",
    "thumb_url": "/images/product/thumb300/244/GOODS-04499125.jpg",
    "thumb_alt": "GOODS-04499125.jpg",
    "thumb_title": "Touhou Project Plush Series Aya Shameimaru FumoFumo Aya. (Medium Size)",
    "thumb_agelimit": 0
  },
  "_embedded": {
    "review_images": [
      {
        "image_url": "/images/product/review/244/GOODS-04499125_01.jpg",
        "thumb_url": "/images/product/rthumb/244/GOODS-04499125_01.jpg",
        "alt": "GOODS-04499125_01.jpg",
        "title": "Touhou Project Plush Series Aya Shameimaru FumoFumo Aya. (Medium Size)[Gift]"
      }
    ],
    "bonus_images": [
      {}
    ],
    "related_items": [
      {
        "gcode": "GOODS-04499117",
        "gname": "[Bonus] Touhou Plush Series 84 Hecatia Lapislazuli FumoFumo Hecatia.",
        "thumb_url": "/images/product/thumb300/244/GOODS-04499117.jpg",
        "thumb_alt": "GOODS-04499117.jpg",
        "thumb_title": "[Bonus] Touhou Plush Series 84 Hecatia Lapislazuli FumoFumo Hecatia.",
        "thumb_agelimit": 0
      }
    ],
    "other_items": [
      {}
    ],
    "makers": [
      {
        "id": 97,
        "name": "Gift"
      }
    ],
    "series_titles": [
      {
        "id": 9619,
        "name": "FumoFumo Series"
      }
    ],
    "original_titles": [
      {
        "id": 211,
        "name": "Touhou Project"
      }
    ],
    "character_names": [
      {
        "id": 4613,
        "name": "Aya Shameimaru"
      }
    ]
  }
}

{
  "RSuccess": "false",
  "RValue": {
    "Error": [
      {
        "RequiredParameter": "",
        "ErrorMessage": "21",
        "ErrorCode": "error_code_21",
        "Fields": [
          []
        ]
      }
    ]
  },
  "RMessage": "Invalid Request 21 "
}

04 November 2025