# Auctions Yahoo Keyword Script (`hello.datawizards/auctions-yahoo-keyword-script`) Actor

Scrape live auction listings from Yahoo Auctions Japan using keywords, capturing title, price, shipping, bids, time left, and images in structured JSON. Ideal for resellers, market researchers, and e-commerce analysts to track trends, monitor competitors, and automate auction data collection.

- **URL**: https://apify.com/hello.datawizards/auctions-yahoo-keyword-script.md
- **Developed by:** [datawizards](https://apify.com/hello.datawizards) (community)
- **Categories:** Agents, Automation, E-commerce
- **Features:** Limited permissions
- **Stats:** 65 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $4.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

***

## 📦 Auctions Yahoo Keyword Script · Apify Actor

Extract **live auction listings from Yahoo Auctions Japan** using keyword searches, delivering structured JSON data ideal for market analysis, competitor monitoring, and e-commerce intelligence.
Built and maintained by [DataWizards](https://linkedin.com/in/data-wizards-aa8080342).

***

### 📌 What Is `Auctions Yahoo Keyword Script`?

The `Auctions Yahoo Keyword Script` Apify Actor allows you to **scrape auction listings by keyword** from Yahoo Auctions Japan. It gathers rich details like product title, current price, shipping, bid count, time remaining, and images — all without logging in.

Perfect for developers, resellers, market researchers, and data analysts looking to automate auction data collection efficiently.

***

### 🧠 Key Features

- ✅ **Keyword-based search** – scrape listings using one or multiple search terms.
- ✅ **Structured JSON output** – includes title, price, shipping, bids, remaining time, and images.
- ✅ **Proxy support** – via Apify Proxy (including **RESIDENTIAL IPs**) for reliable scraping.
- ✅ **Multiple keywords** – handle multiple search terms in a single run.
- ✅ **Fast and lightweight** – optimized for large-scale auction data collection.

***

### 🛠️ Input Schema

Example input for the actor:

```json
{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  },
  "Keyword": [
    "shoe",
    "t=shirt"
  ]
}
```

#### 🔐 Proxy Configuration

- **useApifyProxy**: Set to `true` (required).
- **apifyProxyGroups**: Use `"RESIDENTIAL"` to reduce blocking and improve reliability.

***

### 📤 Output Example

```json
[
  {
    "Keyword": "t=shirt",
    "title": "●HUMAN MADE × Pokemon Made T-Shirt HARAJUKU ピカチュウ XL 黒 HS218291",
    "current_price": "10,000円",
    "shipping_charge": "＋送料1,000円",
    "immediate_discussion": "",
    "product_bid": "1",
    "product_time": "23時間",
    "image_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0112/user/a4c284fd50adbb0245764dfe844cf8fd9b70f0a9b3f22f4576f165536a2e406e/i-img1024x1024-17665615757929d5jlgk850.jpg?pri=l&w=300&h=300&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200"
  }
]
```

***

### 🚀 Use Cases

- 🛍️ **Reseller Market Intelligence** – monitor auction prices and trends.
- 📈 **Competitor Analysis** – track products and bidding activity.
- 🤖 **E-commerce Automation** – feed auction data into dashboards or pricing tools.
- 📊 **Data Aggregation** – compile auction listings for analytics projects.

***

### ✅ Best Practices

- Use **residential proxies** for large-scale scraping.
- Validate keywords for correct and accurate results.
- Avoid excessive calls to prevent throttling by Yahoo Auctions Japan.
- Use meaningful filters to target the most relevant auction items.

***

### 🤝 Support

Need **custom output**, additional fields, or integration help?
**DataWizards are ready to assist!**

📩 Email: <hello.datawizard@gmail.com>
✉️ **Subject**: `Auctions Yahoo Keyword Script – Support Request`
🔗 Connect: [linkedin.com/in/data-wizards-aa8080342](https://linkedin.com/in/data-wizards-aa8080342)

***

### 🧰 Need Something More?

Whether you need **customized scraping**, **simplified JSON outputs**, or integration into apps, we provide fast and reliable solutions.

💡 *DataWizards = Smart, scalable, and professional data extraction.*

***

### 💬 Feedback & Bugs

Spotted a bug or want a new feature?
📧 Email: `hello.datawizard@gmail.com`
🛠️ **Subject**: `Bug Report – Auctions Yahoo Keyword Script`
Or open an issue directly on [Apify](https://apify.com).

***

#### 🔍 Keywords (SEO)

`Yahoo Auctions scraper`, `Yahoo Auctions Japan`, `keyword auction extractor`, `auction price monitoring`, `reseller market data`, `Apify Actor for Yahoo Auctions`, `auction product JSON`, `e-commerce intelligence`, `structured auction data`.

***

#### 🏁 Start scraping smarter with `Auctions Yahoo Keyword Script` — collect Yahoo Auctions data like a pro.

***

# Actor input Schema

## `Keyword` (type: `array`):

The keyword for the spider.

## `itemLimit` (type: `integer`):

Maximum number of items to scrape. Use 0 for no limit.

## `proxyConfiguration` (type: `object`):

Specifies proxy servers that will be used by the scraper in order to hide its origin.

## Actor input object example

```json
{
  "Keyword": [
    "shoe",
    "t=shirt"
  ],
  "itemLimit": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "JP"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "itemLimit": 5,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "JP"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("hello.datawizards/auctions-yahoo-keyword-script").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "itemLimit": 5,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "JP",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("hello.datawizards/auctions-yahoo-keyword-script").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "itemLimit": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "JP"
  }
}' |
apify call hello.datawizards/auctions-yahoo-keyword-script --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hello.datawizards/auctions-yahoo-keyword-script"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/AKfw6QNqW42TGCb3i/builds/bDIgZv899Cs9KKTkW/openapi.json