E-commerce & Marketplaces

Yahoo! Auctions items search

Search live Yahoo! Auctions Japan listings by keyword and/or category with price, buy-it-now, condition, region, seller, listing-type, appraisal, shipping filters and sort. 1 point per returned record.

post/functions/v1/run-yahoo-auctions-items-search

Request

  • Base URL: https://api.neuralverge.ai
  • URL: https://api.neuralverge.ai/functions/v1/run-yahoo-auctions-items-search
  • Auth: HTTP bearer

Request body

keywordstring

Search term (optional when a category is set). e.g. rolex

keyword_excludestring

Excluded words (space-separated, needs a search term). e.g. box case

max_itemsinteger

Max items (up to 500)

start_pageinteger

Starting page

sort'newest' | 'ending_soonest' | 'ending_latest' | 'price_asc' | 'price_desc' | 'buy_now_price_asc' | 'buy_now_price_desc' | 'bids_desc' | 'bids_asc' | 'popular' | 'featured'

Sort by. Options: newest = Newest, ending_soonest = Ending soonest, ending_latest = Ending latest, price_asc = Price: low to high, price_desc = Price: high to low, buy_now_price_asc = Buy-it-now: low to high, buy_now_price_desc = Buy-it-now: high to low, bids_desc = Most bids, bids_asc = Fewest bids, popular = Popular, featured = Featured

condition'new' | 'used' | 'like_new' | 'no_visible_damage' | 'slight_damage' | 'damaged' | 'poor'

Condition. Options: new = New, used = Used (any), like_new = Like new, no_visible_damage = No visible damage, slight_damage = Slight damage, damaged = Damaged, poor = Poor condition

price_mininteger

Min current price (JPY)

price_maxinteger

Max current price (JPY)

buy_now_price_mininteger

Min buy-it-now price (JPY)

buy_now_price_maxinteger

Max buy-it-now price (JPY)

categoryinteger

Category ID

brand_idinteger

Brand ID

region'hokkaido' | 'aomori' | 'iwate' | 'miyagi' | 'akita' | 'yamagata' | 'fukushima' | 'ibaraki' | 'tochigi' | 'gunma' | 'saitama' | 'chiba' | 'tokyo' | 'kanagawa' | 'yamanashi' | 'nagano' | 'niigata' | 'toyama' | 'ishikawa' | 'fukui' | 'gifu' | 'shizuoka' | 'aichi' | 'mie' | 'shiga' | 'kyoto' | 'osaka' | 'hyogo' | 'nara' | 'wakayama' | 'tottori' | 'shimane' | 'okayama' | 'hiroshima' | 'yamaguchi' | 'tokushima' | 'kagawa' | 'ehime' | 'kochi' | 'fukuoka' | 'saga' | 'nagasaki' | 'kumamoto' | 'oita' | 'miyazaki' | 'kagoshima' | 'okinawa' | 'overseas'

Shipped from. Options: hokkaido = Hokkaido, aomori = Aomori, iwate = Iwate, miyagi = Miyagi, akita = Akita, yamagata = Yamagata, fukushima = Fukushima, ibaraki = Ibaraki, tochigi = Tochigi, gunma = Gunma, saitama = Saitama, chiba = Chiba, tokyo = Tokyo, kanagawa = Kanagawa, yamanashi = Yamanashi, nagano = Nagano, niigata = Niigata, toyama = Toyama, ishikawa = Ishikawa, fukui = Fukui, gifu = Gifu, shizuoka = Shizuoka, aichi = Aichi, mie = Mie, shiga = Shiga, kyoto = Kyoto, osaka = Osaka, hyogo = Hyogo, nara = Nara, wakayama = Wakayama, tottori = Tottori, shimane = Shimane, okayama = Okayama, hiroshima = Hiroshima, yamaguchi = Yamaguchi, tokushima = Tokushima, kagawa = Kagawa, ehime = Ehime, kochi = Kochi, fukuoka = Fukuoka, saga = Saga, nagasaki = Nagasaki, kumamoto = Kumamoto, oita = Oita, miyazaki = Miyazaki, kagoshima = Kagoshima, okinawa = Okinawa, overseas = Overseas

seller_type'store' | 'individual'

Seller type. Options: store = Store, individual = Individual

listing_type'auction' | 'fixed_price'

Listing type. Options: auction = Bidding auctions, fixed_price = Fixed price

marketplace'yahoo_auctions' | 'yahoo_flea'

Marketplace. Options: yahoo_auctions = Yahoo! Auctions, yahoo_flea = Yahoo! Flea Market

authenticatedboolean

Authenticity appraisal only

free_shippingboolean

Free shipping only

has_imageboolean

With photo only

new_arrivalboolean

Newly listed only

ending_within_hourboolean

Ending within 1 hour

konbini_pickupboolean

Convenience-store pickup

anonymous_shippingboolean

Anonymous shipping

Response

Run completed.

session_idstring

Session identifier for this run.

kindstring

Data source identifier for this endpoint.

categoryinteger
max_itemsinteger
start_pageinteger
partialboolean

True when the scrape stopped early and returned the records collected so far.

humanstring

Markdown summary of the result, for display.

total_pointsinteger

Points charged for this run.

Changes

No recorded changes to this operation across all 1 revision of this API.