nvNeuralVerge
E-commerce & Marketplaces

Yahoo! Auctions Sold Prices — Closed Auction Search by Keyword

Send a keyword and this source searches completed Yahoo! Auctions Japan auctions and returns each one with the price it actually sold for, plus bid count, watchers, condition, category, shipping prefecture and seller.

Example response
{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "yahoo_auctions_items_closed_search",
  "keyword": "rolex",
  "max_items": 2,
  "start_page": 1,
  "partial": false,
  "human": "# Yahoo! Auctions closed items search\n\n- **keyword:** rolex\n- **max_items:** 2\n- **start_page:** 1\n- **Records returned:** 2\n- **Proxy traffic:** 161.2 KB",
  "machine": {
    "total_items": 2,
    "first_item": {
      "id": "f1245632287",
      "url": "https://auctions.yahoo.co.jp/jp/auction/f1245632287",
      "name": "FF 稼動品 ロレックス ROLEX オイスターパーペチュアル OYSTER PERPETUAL DATE 自動巻き 腕時計 中古品 メンズ カレンダー ヴィンテージ",
      "image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0209/user/b7d3691d5c0196af164a6d11d352a04adbfde8ec14ae04abd28ec27e8cb84339/i-img900x1200-1790150348380659esm9",
      "price": 298000,
      "buy_now_price": null,
      "start_price": 10000,
      "is_taxed": false,
      "bid_count": 124,
      "watch_count": 148,
      "start_at": 1790150623,
      "end_at": 1790780342,
      "condition": "damaged",
      "category": {
        "id": "2084310798",
        "name": "本体"
      },
      "category_path": [
        {
          "id": "0",
          "name": "オークション"
        },
        {
          "id": "23140",
          "name": "アクセサリー、時計"
        }
      ],
      "brand_id": 102294,
      "region": "osaka",
      "region_code": 27,
      "marketplace": "yahoo_auctions",
      "is_fixed_price": false,
      "is_free_shipping": true,
      "is_new_arrival": false,
      "is_appraisal": true,
      "is_featured": false,
      "seller": {
        "id": "Zyf6RidjS3wAY1hi4Qx2NRF6tQhj",
        "url": "https://auctions.yahoo.co.jp/seller/Zyf6RidjS3wAY1hi4Qx2NRF6tQhj",
        "display_name": null,
        "image": null,
        "rating_count": null,
        "good_rating": 99.7,
        "is_store": false,
        "is_best_store": false,
        "is_excellent_seller": null,
        "is_verified": null,
        "is_speed_shipping": null,
        "region": null,
        "region_code": null,
        "profile_message": null,
        "store_licenses": []
      }
    },
    "items": [
      {
        "id": "f1245632287",
        "url": "https://auctions.yahoo.co.jp/jp/auction/f1245632287",
        "name": "FF 稼動品 ロレックス ROLEX オイスターパーペチュアル OYSTER PERPETUAL DATE 自動巻き 腕時計 中古品 メンズ カレンダー ヴィンテージ",
        "image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0209/user/b7d3691d5c0196af164a6d11d352a04adbfde8ec14ae04abd28ec27e8cb84339/i-img900x1200-1790150348380659esm9",
        "price": 298000,
        "buy_now_price": null,
        "start_price": 10000,
        "is_taxed": false,
        "bid_count": 124,
        "watch_count": 148,
        "start_at": 1790150623,
        "end_at": 1790780342,
        "condition": "damaged",
        "category": {
          "id": "2084310798",
          "name": "本体"
        },
        "category_path": [
          {
            "id": "0",
            "name": "オークション"
          },
          {
            "id": "23140",
            "name": "アクセサリー、時計"
          }
        ],
        "brand_id": 102294,
        "region": "osaka",
        "region_code": 27,
        "marketplace": "yahoo_auctions",
        "is_fixed_price": false,
        "is_free_shipping": true,
        "is_new_arrival": false,
        "is_appraisal": true,
        "is_featured": false,
        "seller": {
          "id": "Zyf6RidjS3wAY1hi4Qx2NRF6tQhj",
          "url": "https://auctions.yahoo.co.jp/seller/Zyf6RidjS3wAY1hi4Qx2NRF6tQhj",
          "display_name": null,
          "image": null,
          "rating_count": null,
          "good_rating": 99.7,
          "is_store": false,
          "is_best_store": false,
          "is_excellent_seller": null,
          "is_verified": null,
          "is_speed_shipping": null,
          "region": null,
          "region_code": null,
          "profile_message": null,
          "store_licenses": []
        }
      },
      {
        "id": "f1246070628",
        "url": "https://auctions.yahoo.co.jp/jp/auction/f1246070628",
        "name": "■ROLEX ロレックス ジュビリーブレスレット ベルト コマ パーツ STEELINOX Ref.62510H FF:555 総重量約41.79g【買取まねきや】",
        "image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0209/user/51f851691f96ca1c0a0a326b8dc8c7d6165590e70c73563362193852794ea53c/i-img1170x1170-17904751298267qulhx",
        "price": 74800,
        "buy_now_price": null,
        "start_price": 1000,
        "is_taxed": true,
        "bid_count": 47,
        "watch_count": 28,
        "start_at": 1790475130,
        "end_at": 1790779265,
        "condition": "slight_damage",
        "category": {
          "id": "2084310800",
          "name": "ベルト、ブレスレット"
        },
        "category_path": [
          {
            "id": "0",
            "name": "オークション"
          },
          {
            "id": "23140",
            "name": "アクセサリー、時計"
          }
        ],
        "brand_id": 102294,
        "region": "tokyo",
        "region_code": 13,
        "marketplace": "yahoo_auctions",
        "is_fixed_price": false,
        "is_free_shipping": false,
        "is_new_arrival": false,
        "is_appraisal": false,
        "is_featured": false,
        "seller": {
          "id": "8bdaxRiVapnRAmjjt2iWjM9wQzLXU",
          "url": "https://auctions.yahoo.co.jp/seller/8bdaxRiVapnRAmjjt2iWjM9wQzLXU",
          "display_name": null,
          "image": null,
          "rating_count": null,
          "good_rating": 99.3,
          "is_store": true,
          "is_best_store": false,
          "is_excellent_seller": null,
          "is_verified": null,
          "is_speed_shipping": null,
          "region": null,
          "region_code": null,
          "profile_message": null,
          "store_licenses": []
        }
      }
    ],
    "proxy_traffic_bytes": 165036
  },
  "total_points": 2
}
You send
A keyword, with optional excluded words, sold-price, condition, region, seller-type and sort filters
You get back
Completed auctions with sold price, bids, watchers, condition, category, region and seller
Coverage
Completed auctions on Yahoo! Auctions Japan that Yahoo! still lists as closed.
Price
1 point per returned result, up to 500 per request — $1 per 1,000
Billed per record actually returned, capped by max_items. A search that matches nothing costs nothing.
Comparison

Ways to get this data

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

ApproachWhat it takesCostTrade-off
Browsing closed auctions by handSearch, open each result, note the final priceFree, and slowEnough for one comp, not for a pricing model
Building a scraperWrite it, host it, and repair it when Yahoo! changes the pageEngineering timeA maintenance commitment for something that isn't your product
NeuralVergeOne request, keyword and filters as parameters$1 per 1,000, misses not billedOnly as deep as Yahoo! keeps completed auctions available
Response

What you get back

Every field in the response shown above.

FieldTypeDescription
total_itemsnumberHow many records were returned in this batch (capped by max_items).
first_itemobjectThe first returned record, repeated for convenience.
itemsarrayThe returned records.
idstringYahoo! Auctions listing ID.
urlstringDirect link to the auction page.
namestringListing title, in Japanese as posted.
imagestringPrimary photo URL.
pricenumberPrice the auction closed at, in JPY.
buy_now_pricenumberBuy-it-now price in JPY, null when the listing has none.
start_pricenumberOpening price in JPY.
is_taxedbooleanWhether the listing is flagged as taxed.
bid_countnumberNumber of bids placed.
watch_countnumberNumber of users watching the listing.
start_atnumberListing start time as a Unix timestamp.
end_atnumberAuction end time as a Unix timestamp.
conditionstringCondition code, e.g. damaged, slight_damage, no_visible_damage.
categoryobjectLeaf category id and Japanese name.
category_patharrayCategory ancestors, each with id and name.
brand_idnumberYahoo! Auctions brand ID, when the listing is tagged with one.
regionstringPrefecture the item ships from, e.g. osaka or tokyo.
region_codenumberNumeric code for that prefecture.
marketplacestringWhich marketplace the listing is on, e.g. yahoo_auctions.
is_fixed_pricebooleanWhether the listing is fixed price rather than a bidding auction.
is_free_shippingbooleanWhether shipping is free.
is_new_arrivalbooleanWhether the listing is flagged as newly listed.
is_appraisalbooleanWhether the listing carries an authenticity appraisal flag.
is_featuredbooleanWhether the listing is flagged as featured.
sellerobjectSeller id, URL and the rating and store flags the results page shows. Profile fields such as display_name come back null here; run Yahoo! Auctions seller for the full profile.
Integration

How to run it

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

keyword is required. Set max_items to cap spend; it accepts up to 500 per request. Sort with ended_recent for the freshest comps or price_desc for the highest sold prices.

curl -X POST https://api.neuralverge.ai/functions/v1/run-yahoo-auctions-items-closed-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "rolex", "max_items": 2 }'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Resale pricing

Build a comp set of what similar items really sold for before you bid or list.

Demand signals

Compare bid counts and watcher counts across items to see what draws attention.

Condition premiums

Filter the same keyword by condition to see how much condition moves the sold price.

Authenticity-sensitive goods

Use the is_appraisal flag to separate listings that carried an authenticity appraisal from those that did not.

Coverage & limits

Coverage, freshness and limits

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

Coverage

Completed auctions on Yahoo! Auctions Japan that Yahoo! still lists as closed.

Freshness

Read at request time.

Handling

This source returns publicly visible listing information, stamped with the query it was run for and a session id you can trace.

What it will not do
  • —Only auctions that are still listed as closed can be returned, so very old sales may be missing.
  • —Result records carry the seller's ID and rating but not the full profile; use the seller source for that.
  • —Titles are in Japanese as posted, so keywords usually need to be Japanese to match them.
FAQ

Questions, answered

For this source, yes. It searches completed auctions and the price is what the item sold for.

Related

Related sources

Try yahoo! auctions closed items search on your own data

One request format across every source in the catalog.

Get started