> ## Documentation Index > Fetch the complete documentation index at: https://docs.neuralverge.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi.json post /functions/v1/run-yahoo-auctions-items-search openapi: 3.0.0 info: title: NeuralVerge API version: 1.0.0 description: >- NeuralVerge API for AI research workflows, search, extraction, and structured data source execution. servers: - url: https://api.neuralverge.ai description: NeuralVerge API security: - BearerAuth: [] tags: - name: AI Research description: Research workflows and session tracking. - name: AI Extract description: Schema-driven extraction workflows. - name: AI Agents description: Reusable saved agents executed through the API. - name: Search description: Fast, synchronous web search with no session or polling. - name: Company intelligence description: Company profile lookups from company databases. - name: E-commerce & Marketplaces description: >- Product, seller, and review lookups on Amazon, eBay, Walmart, AliExpress, and Alibaba. - name: Enrichment description: Email and phone enrichment, validation, and discovery. - name: Product reviews description: >- Software and business reviews from Capterra, Gartner Peer Insights, and Trustpilot. - name: Social media description: LinkedIn profile, company, and people lookups. paths: /functions/v1/run-yahoo-auctions-items-search: post: tags: - E-commerce & Marketplaces summary: Yahoo! Auctions items search description: >- 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. requestBody: required: true content: application/json: schema: type: object properties: keyword: description: Search term (optional when a category is set). e.g. rolex type: string keyword_exclude: description: >- Excluded words (space-separated, needs a search term). e.g. e.g. box case type: string max_items: description: Max items (up to 500) type: integer minimum: 0 maximum: 500 default: 25 start_page: description: Starting page type: integer minimum: 0 default: 1 sort: description: >- 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 type: string enum: - newest - ending_soonest - ending_latest - price_asc - price_desc - buy_now_price_asc - buy_now_price_desc - bids_desc - bids_asc - popular - featured condition: description: >- 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 type: string enum: - new - used - like_new - no_visible_damage - slight_damage - damaged - poor price_min: description: Min current price (JPY) type: integer minimum: 0 price_max: description: Max current price (JPY) type: integer minimum: 0 buy_now_price_min: description: Min buy-it-now price (JPY) type: integer minimum: 0 buy_now_price_max: description: Max buy-it-now price (JPY) type: integer minimum: 0 category: description: Category ID type: integer minimum: 0 brand_id: description: Brand ID type: integer minimum: 0 region: description: >- 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 type: string enum: - 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 seller_type: description: 'Seller type. Options: store = Store, individual = Individual' type: string enum: - store - individual listing_type: description: >- Listing type. Options: auction = Bidding auctions, fixed_price = Fixed price type: string enum: - auction - fixed_price marketplace: description: >- Marketplace. Options: yahoo_auctions = Yahoo! Auctions, yahoo_flea = Yahoo! Flea Market type: string enum: - yahoo_auctions - yahoo_flea authenticated: description: Authenticity appraisal only type: boolean free_shipping: description: Free shipping only type: boolean has_image: description: With photo only type: boolean new_arrival: description: Newly listed only type: boolean ending_within_hour: description: Ending within 1 hour type: boolean konbini_pickup: description: Convenience-store pickup type: boolean anonymous_shipping: description: Anonymous shipping type: boolean example: max_items: 2 responses: '200': description: Run completed. content: application/json: schema: type: object properties: session_id: type: string description: Session identifier for this run. kind: type: string description: Data source identifier for this endpoint. category: type: integer max_items: type: integer start_page: type: integer partial: type: boolean description: >- True when the scrape stopped early and returned the records collected so far. human: type: string description: Markdown summary of the result, for display. machine: type: object properties: total_items: type: integer first_item: type: object properties: id: type: string url: type: string name: type: string image: type: string price: type: integer buy_now_price: type: integer start_price: type: integer bid_count: type: integer end_at: type: integer category_id: type: string category_path_ids: type: array items: type: string marketplace: type: string is_free_shipping: type: boolean accepts_easy_payment: type: boolean seller_id: type: string seller_url: type: string items: type: array items: type: object properties: id: type: string url: type: string name: type: string image: type: string price: type: integer buy_now_price: type: integer start_price: type: integer bid_count: type: integer end_at: type: integer category_id: type: string category_path_ids: type: array items: type: string marketplace: type: string is_free_shipping: type: boolean accepts_easy_payment: type: boolean seller_id: type: string seller_url: type: string proxy_traffic_bytes: type: integer description: Structured result payload. total_points: type: integer description: Points charged for this run. example: session_id: 11111111-1111-1111-1111-111111111111 kind: yahoo_auctions_items_search category: 23336 max_items: 2 start_page: 1 partial: false human: |- # Yahoo! Auctions items search - **category:** 23336 - **max_items:** 2 - **start_page:** 1 - **Records returned:** 2 - **Proxy traffic:** 116.2 KB machine: total_items: 2 first_item: id: t1246544651 url: https://auctions.yahoo.co.jp/jp/auction/t1246544651 name: >- 国内即日発送 純正同等新品 CF-VZSU90JS バッテリー Panasonic Let'snote CF-LX3 CF-LX4 CF-LX5 CF-LX6 電池パック交換 パソコン battery image: >- https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/ea68c0b66f1d69f7ca727a9e432c21a171907b450e705561bc23e63a6db8cac0/i-img1200x1200-179078134742034o6nh price: 5490 buy_now_price: 5490 start_price: 5490 bid_count: 0 end_at: 1791382548 category_id: '2084039776' category_path_ids: - '0' - '23336' marketplace: yahoo_auctions is_free_shipping: true accepts_easy_payment: true seller_id: 6Jm7prTSvFjBC8t5KxJX9jLbKrGen seller_url: >- https://auctions.yahoo.co.jp/seller/6Jm7prTSvFjBC8t5KxJX9jLbKrGen items: - id: t1246544651 url: https://auctions.yahoo.co.jp/jp/auction/t1246544651 name: >- 国内即日発送 純正同等新品 CF-VZSU90JS バッテリー Panasonic Let'snote CF-LX3 CF-LX4 CF-LX5 CF-LX6 電池パック交換 パソコン battery image: >- https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/ea68c0b66f1d69f7ca727a9e432c21a171907b450e705561bc23e63a6db8cac0/i-img1200x1200-179078134742034o6nh price: 5490 buy_now_price: 5490 start_price: 5490 bid_count: 0 end_at: 1791382548 category_id: '2084039776' category_path_ids: - '0' - '23336' marketplace: yahoo_auctions is_free_shipping: true accepts_easy_payment: true seller_id: 6Jm7prTSvFjBC8t5KxJX9jLbKrGen seller_url: >- https://auctions.yahoo.co.jp/seller/6Jm7prTSvFjBC8t5KxJX9jLbKrGen - id: x1246536082 url: https://auctions.yahoo.co.jp/jp/auction/x1246536082 name: >- 国内即日発送!! 純正同等新品!! FPCBP345Z バッテリー 富士通 LIFEBOOK UH55/H UH572 シリーズ 電池パック交換 パソコン 内蔵battery 単品 image: >- https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/ea68c0b66f1d69f7ca727a9e432c21a171907b450e705561bc23e63a6db8cac0/i-img1200x1200-17907813470244ral15 price: 3390 buy_now_price: 3390 start_price: 3390 bid_count: 0 end_at: 1791382548 category_id: '2084039776' category_path_ids: - '0' - '23336' marketplace: yahoo_auctions is_free_shipping: true accepts_easy_payment: true seller_id: 6Jm7prTSvFjBC8t5KxJX9jLbKrGen seller_url: >- https://auctions.yahoo.co.jp/seller/6Jm7prTSvFjBC8t5KxJX9jLbKrGen proxy_traffic_bytes: 119003 total_points: 2 '400': description: Bad Request '401': description: Unauthorized '402': description: Payment Required '500': description: Internal Error components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key ````