Can I look up an auction by URL instead of ID?

Yes. The item field accepts either the auction ID or the full auction URL.

Is the text translated?

No. Titles, descriptions and condition labels come back in Japanese exactly as posted.

Do I pay for lookups that come back empty?

No. You are charged per result, so a request that finds nothing costs nothing. Testing this against a messy list is free to get wrong.

What does a lookup cost?

5 points per successful run, which is $5 per 1,000. Only auctions that resolve are charged.

E-commerce & Marketplaces

Yahoo! Auctions Item Data — Price, Bids & Seller by Auction ID

Send a Yahoo! Auctions Japan auction ID or URL and this source returns the listing as structured data: current or winning price, bid count, condition, category, description, photos, shipping terms, accepted payment methods, the highest bidders and the seller.

Run it in the app Read the API docs

Example response

{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "yahoo_auctions_item",
  "item": "d1236130164",
  "item_id": "d1236130164",
  "human": "# Yahoo! Auctions item\n\n- **Item:** d1236130164\n- **Proxy traffic:** 125.8 KB\n- **Name:** K9金無垢ロレックス ROLEX ユニコーン UNICORN Cushion Case アンティーク1930年 総重量25.1ｇ オリジナル文字盤 メンズ ボーイズ 動作良好\n- **Status:** closed\n- **Winning price:** 466,000 JPY\n- **Bids:** 246\n- **Ends/ended:** 2026-08-09 14:25 UTC\n- **Category:** その他",
  "machine": {
    "item": {
      "id": "d1236130164",
      "url": "https://auctions.yahoo.co.jp/jp/auction/d1236130164",
      "name": "K9金無垢ロレックス ROLEX ユニコーン UNICORN Cushion Case アンティーク1930年 総重量25.1ｇ オリジナル文字盤 メンズ ボーイズ 動作良好",
      "status": "closed",
      "price": 466000,
      "start_price": 1,
      "buy_now_price": 998000,
      "tax_rate": null,
      "bid_count": 246,
      "bidder_count": 20,
      "watch_count": 59,
      "quantity": 1,
      "start_at": 1785637536,
      "end_at": 1786285502,
      "condition": "no_visible_damage",
      "condition_name": "目立った傷や汚れなし",
      "category": {
        "id": "2084024489",
        "name": "その他"
      },
      "category_path": [
        {
          "id": "0",
          "name": "オークション"
        },
        {
          "id": "23140",
          "name": "アクセサリー、時計"
        }
      ],
      "brand": {
        "id": "102294",
        "name": "ROLEX"
      },
      "marketplace": "yahoo_auctions",
      "description": "K9 シャンパンゴールド金無垢 ROLEX UNICORN（ロレックス ユニコーン） Cushion Case(クッションケース) Original Dial (オリジナル文字盤) アンティーク 1930年代製造\n  最高級時計の風格を感じさせる逸品です。\n\n  希少中の希少1930年代製造 K9 シャンパンゴールド金無垢 ROLEX UNICORN（ロレックス ユニコーン） Cushion Ca",
      "description_html": "<DIV><B><SPAN>K9 </SPAN></B><B><SPAN>シャンパンゴールド金無垢 <SPAN>ROLEX UNICORN</SPAN>（ロレックス ユニコーン） <SPAN>Cushion Case(</SPAN>クッションケース<SPAN>) Original Dial (</SPAN>オリジナル文字盤<SPAN>) </SPAN>アンティーク <SPAN>1930</SPAN",
      "image": "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0207/user/823955b7c67caf7d7446abef49c093e3d97cf22eb0b89d220560cdd05944600b/i-img1200x1200-1783323651243147zfotde31.jpg",
      "images": [
        "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0207/user/823955b7c67caf7d7446abef49c093e3d97cf22eb0b89d220560cdd05944600b/i-img1200x1200-1783323651243147zfotde31.jpg",
        "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0207/user/823955b7c67caf7d7446abef49c093e3d97cf22eb0b89d220560cdd05944600b/i-img1200x1200-178332365124331067dujv31.jpg"
      ],
      "shipping_paid_by": "seller",
      "shipping_schedule": "支払い手続きから1～2日で発送",
      "shipping_methods": [
        {
          "id": "YUPACK",
          "name": "ゆうパック",
          "is_official_delivery": false,
          "can_privacy_delivery": false,
          "is_flat_fee": false
        }
      ],
      "is_worldwide_delivery": false,
      "is_anonymous_delivery": false,
      "is_automatic_extension": true,
      "is_early_closing": true,
      "is_offer_accepted": false,
      "is_returnable": false,
      "return_policy": null,
      "accepts_credit_card": true,
      "accepts_paypay": true,
      "accepts_bank_transfer": true,
      "answered_question_count": 0,
      "unanswered_question_count": 0,
      "highest_bidders": [
        {
          "display_name": "ワカメ",
          "rating_count": 76
        }
      ],
      "seller": {
        "id": "2WZF25HbH5hVYuP5xt9wEg1CArvMM",
        "url": "https://auctions.yahoo.co.jp/seller/2WZF25HbH5hVYuP5xt9wEg1CArvMM",
        "display_name": "MrDiamond",
        "image": "https://s.yimg.jp/images/serp/as/ic_prof_default.png",
        "rating_count": 398,
        "good_rating": 98.5,
        "is_store": false,
        "is_best_store": false,
        "is_excellent_seller": false,
        "is_verified": true,
        "is_speed_shipping": true,
        "region": "miyazaki",
        "region_code": 45,
        "profile_message": null,
        "store_licenses": []
      }
    },
    "proxy_traffic_bytes": 128811
  },
  "total_points": 5
}

You send: A Yahoo! Auctions auction ID or URL
You get back: Price, bids, condition, category, description, photos, shipping, payment methods, highest bidders and seller
Coverage: Yahoo! Auctions Japan listings with a public auction page, live or completed.
Price: 5 pts — $5 per 1,000; Charged only when the item resolves. An auction ID or URL that doesn't resolve is not billed.

Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

Approach	What it takes	Cost	Trade-off
Reading the auction page by hand	Open the page, translate it, copy the numbers	Free, and slow	Fine for one auction, useless across a watch list
Building a scraper	Write it, host it, and repair it when Yahoo! changes the page	Engineering time	A maintenance commitment for something that isn't your product
NeuralVerge	One request per auction	$5 per 1,000, misses not billed	Returns what the listing publishes at request time; live prices keep moving until the auction ends

Response

What you get back

Every field in the response shown above.

Field	Type	Description
`item`	object	The listing, with the keys below.
`id`	string	Yahoo! Auctions listing ID.
`url`	string	Direct link to the auction page.
`name`	string	Listing title, in Japanese as posted.
`status`	string	Whether the auction is live or closed, e.g. closed.
`price`	number	Current price, or the winning price once the auction has closed, in JPY.
`start_price`	number	Opening price in JPY.
`buy_now_price`	number	Buy-it-now price in JPY, null when none is set.
`tax_rate`	number	Tax rate, null when the listing does not state one.
`bid_count`	number	Number of bids placed.
`bidder_count`	number	Number of distinct bidders.
`watch_count`	number	Number of users watching the listing.
`quantity`	number	Quantity offered.
`start_at`	number	Listing start time as a Unix timestamp.
`end_at`	number	Auction end time as a Unix timestamp.
`condition`	string	Condition code, e.g. no_visible_damage.
`condition_name`	string	The condition label as shown on the listing, in Japanese.
`category`	object	Leaf category id and Japanese name.
`category_path`	array	Category ancestors, each with id and name.
`brand`	object	Brand id and name, when the listing is tagged with one.
`marketplace`	string	Which marketplace the listing is on, e.g. yahoo_auctions.
`description`	string	Seller's description as plain text.
`description_html`	string	The same description with its original HTML markup.
`image`	string	Primary photo URL.
`images`	array	All photo URLs.
`shipping_paid_by`	string	Who pays shipping, e.g. seller.
`shipping_schedule`	string	Dispatch timing the seller states, in Japanese.
`shipping_methods`	array	Offered carriers, each with id, name and flags for official delivery, privacy delivery and flat fee.
`is_worldwide_delivery`	boolean	Whether the seller ships worldwide.
`is_anonymous_delivery`	boolean	Whether anonymous delivery is offered.
`is_automatic_extension`	boolean	Whether the auction extends automatically on late bids.
`is_early_closing`	boolean	Whether the seller allows early closing.
`is_offer_accepted`	boolean	Whether the seller accepts offers.
`is_returnable`	boolean	Whether returns are accepted.
`return_policy`	string	Return policy text, null when none is given.
`accepts_credit_card`	boolean	Whether credit card payment is accepted.
`accepts_paypay`	boolean	Whether PayPay is accepted.
`accepts_bank_transfer`	boolean	Whether bank transfer is accepted.
`answered_question_count`	number	Questions the seller has answered.
`unanswered_question_count`	number	Questions still waiting for an answer.
`highest_bidders`	array	Top bidders, each with display_name and rating_count.
`seller`	object	Seller id, URL, display name, rating count, positive-feedback percentage and store, verification and shipping-speed flags.

Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

One auction per request. The auction ID is the code in the listing URL, for example d1236130164. Keep seller.id if you plan to run a seller lookup or pull the seller's other listings next.

curl -X POST https://api.neuralverge.ai/functions/v1/run-yahoo-auctions-items \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "item": "d1236130164" }'

Use cases

What teams use it for

Where this field shows up in an actual workflow.

Resale valuation

Check what a comparable item actually sold for and how many bids it took to get there.

Sourcing from Japan

Read condition, shipping terms and payment methods before deciding whether a listing is worth chasing.

Watch lists

Re-run an auction ID as it approaches its end time to follow the price and bid count.

Feeding a seller lookup

Take seller.id from the result and run it through Yahoo! Auctions seller or seller reviews.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Yahoo! Auctions Japan listings with a public auction page, live or completed.

Freshness

Read at request time.

Handling

This source returns publicly visible listing information, stamped with the auction ID it was read from and a session id you can trace. Listings can include seller-written text and bidder display names; treat those under your own data-protection rules.

What it will not do

—Live prices and bid counts reflect the moment of the request and change until the auction ends.
—Titles, descriptions and condition labels are in Japanese as the seller wrote them.
—How long a completed auction stays readable is up to Yahoo!; older IDs may stop resolving.

FAQ

Questions, answered

Yes. The status field says whether the auction is live or closed, and for a closed auction the price is the winning price.

Related sources

Yahoo! Auctions items search

Search live listings by keyword or category.

Yahoo! Auctions seller

The seller's profile, badges and rating.

Yahoo! Auctions closed items search

See what comparable items actually sold for.

All e-commerce & marketplaces

Amazon, eBay, Walmart, AliExpress, Alibaba and Yahoo! Auctions product, seller and review data.

Try yahoo! auctions item on your own data

One request format across every source in the catalog.

Get started