ZenMarket Yahoo Auctions Scraper

This Apify Actor scrapes Yahoo Auctions Japan listings via ZenMarket.jp. It allows you to search for items, filter by category, and extract detailed auction information including prices in USD.

Features

• Search: Search for any item on Yahoo Auctions Japan.
• Category Filtering: Optionally filter results by a specific category ID.
• Ending Soon: Automatically sorts results by "Ending Time" (soonest first) to help you find auctions closing shortly.
• USD Pricing: Extracts current prices converted to USD.
• Detailed Output: Extracts item name, current price, main photo, absolute ending date, URL, and categories.
• Pagination: Scrapes multiple pages of results.

Input Parameters

The input of this Actor is a JSON object with the following fields:

Field	Type	Description	Required	Default
searchTerm	String	The term to search for (e.g., "camera", "pokemon cards").	Yes	-
categoryID	String	The category ID to filter results. You can find this ID in the URL of a category page on ZenMarket (e.g., 2084007644).	No	-
maxPages	Integer	The maximum number of pages to scrape.	No	1
maxRemainingHours	Integer	Limit scraping to items ending within this many hours (e.g., 24 for "ending today").	No	-

Example Input

{
    "searchTerm": "camera",
    "categoryID": "2084007644",
    "maxPages": 2,
    "maxRemainingHours": 24
}

Output

The Actor stores the results in a dataset. Each item is a JSON object representing an auction.

Example Output

{
  "name": "Nikon F3 Eye Level Film Camera Body",
  "current_price": 250.00,
  "photos": [
    "https://ys.zenmarket.jp/..."
  ],
  "ending_date": "2025-12-15T14:30:00.000000+00:00",
  "url": "https://zenmarket.jp/en/auction.aspx?itemCode=x123456789",
  "categories": [
    "Film Cameras",
    "Nikon"
  ]
}

Local Development

To run this Actor locally:

1. Install dependencies:

   $pip install -r requirements.txt
   

2. Run the Actor:

   $apify run
   

   You can modify the input in storage/key_value_stores/default/INPUT.json.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.