APIFuseAPIFuse
DocsServicesPlaygroundStatus
Log inSign up

Service

Demaecan

Japan, FoodBeta
Try in PlaygroundOpen the API reference

Overview

Use Demaecan when you need public Japanese food-delivery discovery data such as postal-code address candidates, shop lists, menu detail, item options, reviews, and genre filters. Access is fully managed by APIFuse with no setup required.

Status

Degraded

97.56%30-day uptimeAvg response4773ms

2026-09-192026-10-042026-10-18

Setup

Auth mode
Managed key
Credentials
  • A managed key scoped to demaecan
Sandbox
Not available

APIs

Selecting a row opens the reference for that API.

MethodAPIPathSummary
POST/v1/demaecan/genre-listFetches the genre filters and recommended filter conditions available for an 11-digit Demaecan block_code. Use when you need valid genre_code values before filtering demaecan:search-shops. Do NOT use to list shops — use demaecan:search-shops instead. Returns block_code, genres[] and recommend_conditions[] (each with genre_code, genre_name, image_url, is_visible), and summary.
POST/v1/demaecan/item-detailFetches detail, sizes, and option groups for one Demaecan menu item identified by shop_id, block_code, menu_code, item_code, and size_code. Use when you have these values from demaecan:shop-detail (menu[].items[]) and need option groups, sizes, or orderability. Do NOT use to browse a shop's menu — use demaecan:shop-detail instead. Forward size_code unchanged from shop-detail; items whose size_code is null cannot be looked up. Returns shop_name, item_name, chain_name, description, image_url, is_orderable, is_stockout, is_instore_price, sizes[], option_groups[], and summary.
POST/v1/demaecan/resolve-addressResolves a Japanese 7-digit postal code into Demaecan address candidates and 11-digit delivery block codes. Use when you only have a postal code and need a block_code for demaecan:search-shops, demaecan:genre-list, demaecan:shop-detail, or demaecan:item-detail. Do NOT use for free-text addresses or for listing shops — use demaecan:search-shops with a block_code instead. Returns postal_code, addresses[] (block_code, address_name, postal_code), and summary.
POST/v1/demaecan/search-shopsSearches Demaecan shops that deliver to an 11-digit block_code, with optional genre_code, sort_by (recommend, wait_time, or evaluation), wait_time (0, 30, 60, or 90 minutes), and page. Use when you already have a block_code from demaecan:resolve-address and need a shop list or a shop_id. Do NOT use with a postal code — use demaecan:resolve-address first. Do NOT use for a single shop's menu or reviews — use demaecan:shop-detail instead. Returns block_code, page, total_count, has_next_page, shops[] (shop_id, name, rating, wait_time, delivery_fee, status, and more), address_name, and summary.

Related guides

  • Issue a sandbox key and make your first reservation.

  • APIFuse holds the partner credentials. You hold one managed key.

  • Receive events such as reservation confirmations and delivery updates.

  • Service outages and gateway errors normalise into one error model.

POST/v1/demaecan/shop-detailFetches one Demaecan shop's detail, menu categories with their items, paginated reviews, and rating distribution. Use when you have a shop_id from demaecan:search-shops and need menus, the menu_code/item_code/size_code values for an item, or reviews; pass the same block_code that produced the shop_id, otherwise detail may be unavailable. Do NOT use to find shops — use demaecan:search-shops instead. Do NOT use for an item's sizes and option groups — use demaecan:item-detail instead. Returns shop, menu[] (categories with items), reviews, rating_distribution (null when unavailable), and summary.
Genre List
Item Detail
Resolve Address
Search Shops
Quickstart
Managed keys
Overview
Error model
Shop Detail