# New Joonggonara listings for a keyword

**Use case:** 

New Joonggonara listings for a keyword: one flat row per listing, $2 per 1,000 returned. No login needed. Fast and reliable. Ships clean, structured JSON.

## Input

```json
{
  "searches": [
    "iphone"
  ],
  "testRun": false,
  "onlyFound": false,
  "includeKeywords": [],
  "excludeKeywords": [],
  "maxListingsPerSearch": 50,
  "deltaMode": true,
  "deltaName": "joonggonara-new-listing-alerts",
  "alertOnNew": true,
  "alertOnPriceDrop": true,
  "minPriceDropPct": 5,
  "skipFirstRun": true,
  "includeSellerInfo": false,
  "columns": [
    "searchQuery",
    "listingCount",
    "totalAvailable",
    "truncated",
    "newCount",
    "priceDropCount",
    "listings",
    "listingId",
    "url",
    "title",
    "price",
    "currency",
    "shippingFeeApplies",
    "listingStatus",
    "postedAt",
    "city",
    "sellerType",
    "certifiedSeller",
    "wishCount",
    "chatCount",
    "imageUrl",
    "sellerHash",
    "sellerId",
    "isNew",
    "changeType",
    "previousPrice",
    "priceDropPct",
    "firstSeenAt"
  ],
  "expandRows": true,
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

## Output

```json
{
  "query": {
    "label": "Search submitted",
    "format": "string"
  },
  "found": {
    "label": "Found?",
    "format": "boolean"
  },
  "status": {
    "label": "Status",
    "format": "string"
  },
  "message": {
    "label": "Details",
    "format": "string"
  },
  "searchQuery": {
    "label": "Search",
    "format": "string"
  },
  "listingCount": {
    "label": "Listings returned",
    "format": "number"
  },
  "totalAvailable": {
    "label": "Total matching on Joonggonara",
    "format": "number"
  },
  "truncated": {
    "label": "More results were available",
    "format": "boolean"
  },
  "newCount": {
    "label": "New listings this run",
    "format": "number"
  },
  "priceDropCount": {
    "label": "Price drops this run",
    "format": "number"
  },
  "listings": {
    "label": "All listings found (full list)",
    "format": "array"
  },
  "listingId": {
    "label": "Joonggonara listing ID",
    "format": "string"
  },
  "url": {
    "label": "Listing link",
    "format": "string"
  },
  "title": {
    "label": "Title",
    "format": "string"
  },
  "price": {
    "label": "Price (KRW)",
    "format": "number"
  },
  "currency": {
    "label": "Currency",
    "format": "string"
  },
  "shippingFeeApplies": {
    "label": "A separate parcel fee applies",
    "format": "boolean"
  },
  "listingStatus": {
    "label": "Listing status",
    "format": "string"
  },
  "postedAt": {
    "label": "Posted (date)",
    "format": "string"
  },
  "city": {
    "label": "Location",
    "format": "string"
  },
  "sellerType": {
    "label": "Seller type",
    "format": "string"
  },
  "certifiedSeller": {
    "label": "Certified seller",
    "format": "boolean"
  },
  "wishCount": {
    "label": "Wishlist count",
    "format": "number"
  },
  "chatCount": {
    "label": "Chat count",
    "format": "number"
  },
  "imageUrl": {
    "label": "Image",
    "format": "string"
  },
  "sellerHash": {
    "label": "Seller (anonymous hash)",
    "format": "string"
  },
  "sellerId": {
    "label": "Seller ID (only with seller info on)",
    "format": "string"
  },
  "isNew": {
    "label": "Is this listing new?",
    "format": "boolean"
  },
  "changeType": {
    "label": "Change type",
    "format": "string"
  },
  "previousPrice": {
    "label": "Previous price (KRW)",
    "format": "number"
  },
  "priceDropPct": {
    "label": "Price drop %",
    "format": "number"
  },
  "firstSeenAt": {
    "label": "First seen on a run",
    "format": "string"
  },
  "scrapedAt": {
    "label": "Checked at",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Joonggonara Scraper: Korea New Listing Alerts](https://apify.com/accountable_eel/joonggonara-listing-lookup.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/accountable_eel/joonggonara-listing-lookup.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

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 full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/accountable_eel/joonggonara-listing-lookup.md

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`).