APIFuseAPIFuse
DocsServicesPlaygroundStatus
Log inSign up

Service

Buyee

Japan, ShoppingExperimental
Try in PlaygroundOpen the API reference

Overview

Search Buyee's public Amazon Japan, Yahoo! Auctions, Mercari, Rakuma, PayPay Flea Market, Yahoo! Shopping, and Rakuten Ichiba catalogs and inspect normalized international shipping data without authentication.

Status

Degraded

85.09%30-day uptimeAvg response3960ms

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

Setup

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

APIs

Selecting a row opens the reference for that API.

MethodAPIPathSummary
POST/v1/buyee/get-auctionReturns normalized details for one Yahoo! Auctions item on Buyee by auction_id, including its current and buyout prices, bid count, and images. Use when you have an auction_id from buyee:search-auctions. Do NOT use for Amazon Japan, flea-market, Yahoo! Shopping, or Rakuten Ichiba items — use buyee:get-product, buyee:get-flea-market-item, buyee:get-shopping-item, or buyee:get-rakuten-item instead. Returns auction_id, title, current_price_jpy, buyout_price_jpy, bid_count, images, and auction_url.
POST/v1/buyee/get-flea-market-itemReturns details for one Mercari, Rakuma, or PayPay Flea Market item through Buyee, including its condition, seller ratings, images, and price in Japanese yen. Use when you have a marketplace and item_id from buyee:search-flea-market-items. Do NOT use for Amazon Japan, Yahoo! Auctions, Yahoo! Shopping, or Rakuten Ichiba items — use buyee:get-product, buyee:get-auction, buyee:get-shopping-item, or buyee:get-rakuten-item instead. Returns marketplace, item_id, title, price_jpy, condition, seller_name, seller_rating_positive_count, seller_rating_neutral_count, seller_rating_negative_count, images, and item_url.
POST/v1/buyee/get-productReturns normalized details for one Buyee Amazon Japan product by product_id, including its condition, images, and variation choices. Use when you already have a product_id from buyee:search-products. Do NOT use for seller offers — use buyee:list-offers instead. Do NOT use for Yahoo! Auctions, flea-market, Yahoo! Shopping, or Rakuten Ichiba items — use buyee:get-auction, buyee:get-flea-market-item, buyee:get-shopping-item, or buyee:get-rakuten-item instead. Returns product_id, title, price_jpy, condition, images, variations, and product_url.
POST/v1/buyee/get-rakuten-itemReturns normalized details for one Rakuten Ichiba (楽天市場) item on Buyee by item_id, including its Japanese-yen price, seller, category, description, and images, plus a content_trust marker showing that marketplace text has not been independently verified. Use when you have an item_id from buyee:search-rakuten-items. Do NOT use for Amazon Japan, Yahoo! Auctions, flea-market, or Yahoo! Shopping items — use buyee:get-product, buyee:get-auction, buyee:get-flea-market-item, or buyee:get-shopping-item instead. Returns item_id, item_url, title, price_jpy, seller_name, category_path, description, images, and content_trust.

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.

Incidents

Observed on this service over the last 30 days.

POST/v1/buyee/get-shopping-itemReturns normalized details for one Yahoo! Shopping item on Buyee by item_id, including its selling price, catalog price when available, images, description, and current orderability. Use when you have an item_id from buyee:search-shopping-items. Do NOT use for Amazon Japan, Yahoo! Auctions, flea-market, or Rakuten Ichiba items — use buyee:get-product, buyee:get-auction, buyee:get-flea-market-item, or buyee:get-rakuten-item instead. Returns item_id, title, price_jpy, catalog_price_jpy, condition, images, item_url, source_item_url, description, max_order_quantity, and is_orderable.
POST/v1/buyee/list-offersLists the seller offers currently shown for one Buyee Amazon Japan product, with opaque offer identifiers, Japanese-yen prices, and decoded seller names. Use when the user wants to compare sellers or prices for a known product_id. Do NOT use for product details such as images or variations — use buyee:get-product instead. Returns offers (offer_id, price_jpy, seller_name).
POST/v1/buyee/list-shipping-destinationsLists Buyee's current international shipping destinations with the internal destination_id values required by buyee:quote-shipping. Use when you need a destination_id before requesting a shipping quote. Do NOT use for prices — use buyee:quote-shipping instead. Destination identifiers are Buyee-internal integers, not ISO country codes. Returns destinations (destination_id, name).
POST/v1/buyee/quote-shippingQuotes Buyee shipping methods and prices for a destination and parcel weight and dimensions, keeping unavailable methods and nullable delivery estimates. Use when you have a destination_id from buyee:list-shipping-destinations and the parcel's weight_grams, length_cm, width_cm, and height_cm. Do NOT use for looking up destinations — use buyee:list-shipping-destinations instead. Each method also reports eligibility flags (prohibited, weight_over, size_over); null means Buyee reports unknown. Returns methods (method_name, price_jpy, delivery_days_min, delivery_days_max, available, prohibited, weight_over, size_over).
POST/v1/buyee/search-auctionsSearches Yahoo! Auctions listings on Buyee by keyword and returns one result page. Use when the user wants Yahoo! Auctions items with bids or buyout prices. Do NOT use for Amazon Japan, Mercari/Rakuma/PayPay Flea Market, Yahoo! Shopping, or Rakuten Ichiba — use buyee:search-products, buyee:search-flea-market-items, buyee:search-shopping-items, or buyee:search-rakuten-items instead. The upstream returns up to 100 cards per one-indexed page and exposes no total count. Returns items (auction_id, title, current_price_jpy, buyout_price_jpy, bid_count, image_url, auction_url) and page.
POST/v1/buyee/search-flea-market-itemsSearches Mercari, Rakuma, or PayPay Flea Market through Buyee by keyword for the selected marketplace and returns one upstream page. Use when the user wants second-hand or consumer-to-consumer listings from one of those three marketplaces. Do NOT use for Amazon Japan, Yahoo! Auctions, Yahoo! Shopping, or Rakuten Ichiba — use buyee:search-products, buyee:search-auctions, buyee:search-shopping-items, or buyee:search-rakuten-items instead. The upstream result count is intentionally omitted because callers cannot page reliably against it. Returns items (marketplace, item_id, title, price_jpy, image_url, item_url) and page.
POST/v1/buyee/search-productsSearches Buyee's public Amazon Japan catalog by keyword and returns one normalized result page. Use when the user wants Amazon Japan listings sold through Buyee. Do NOT use for Yahoo! Auctions, Mercari/Rakuma/PayPay Flea Market, Yahoo! Shopping, or Rakuten Ichiba — use buyee:search-auctions, buyee:search-flea-market-items, buyee:search-shopping-items, or buyee:search-rakuten-items instead. Prices are in Japanese yen when present; the upstream does not expose a reliable pageable total, so no total count is returned. Returns items (product_id, title, price_jpy, image_url, product_url) and page.
POST/v1/buyee/search-rakuten-itemsSearches Rakuten Ichiba (楽天市場) through Buyee by keyword and returns one normalized result page. Use when the user wants Rakuten Ichiba listings. Do NOT use for Amazon Japan, Yahoo! Auctions, Mercari/Rakuma/PayPay Flea Market, or Yahoo! Shopping — use buyee:search-products, buyee:search-auctions, buyee:search-flea-market-items, or buyee:search-shopping-items instead. Prices are in Japanese yen (JPY); no total count is returned because the available results do not support reliable paging. Returns items (item_id, title, price_jpy, seller_id, category_path, item_url) and page.
POST/v1/buyee/search-shopping-itemsSearches Buyee's public Yahoo! Shopping catalog by keyword and returns one normalized result page, optionally ordered by sort_by. Use when the user wants new retail items from Yahoo! Shopping stores. Do NOT use for Amazon Japan, Yahoo! Auctions, Mercari/Rakuma/PayPay Flea Market, or Rakuten Ichiba — use buyee:search-products, buyee:search-auctions, buyee:search-flea-market-items, or buyee:search-rakuten-items instead. Prices are in Japanese yen; no total count is returned because the upstream page does not support reliable paging. Returns items (item_id, title, price_jpy, condition, seller_name, image_url, item_url) and page.
Get a Buyee Yahoo! Auctions item
Get a Buyee flea-market item
Get Buyee product details
Get a Buyee Rakuten Ichiba (楽天市場) item
Quickstart
Managed keys
Overview
Error model
Get a Yahoo! Shopping item through Buyee
List Buyee product offers
List Buyee shipping destinations
Get a Buyee shipping quote
Search Yahoo! Auctions on Buyee
Search Buyee flea markets
Search Amazon Japan products with Buyee
Search Rakuten Ichiba (楽天市場) items through Buyee
Search Yahoo! Shopping items through Buyee
  • Elevated error rate on Buyee

    Started2026-10-18 15:59 UTCDuration45mPeak error rate6.78%

    • Search Yahoo! Auctions on Buyee
    Resolved

    Elevated error rate on Buyee

    Started2026-10-16 17:04 UTCDuration1h 31mPeak error rate10.13%

    • Get a Yahoo! Shopping item through Buyee
    Resolved

    Outage on Buyee

    Started2026-10-15 06:54 UTCDuration1h 33mPeak error rate11.85%

    • Get a Buyee flea-market item
    Resolved