# Mercari Japan Listing API for Your Own App

**Use case:** 

Query Mercari Japan search results by keyword from your own script or app: structured price and listing data as clean JSON. $2 per 1,000 returned.

## Input

```json
{
  "searches": [
    "nintendo switch"
  ],
  "testRun": false,
  "onlyFound": false,
  "includeKeywords": [],
  "excludeKeywords": [],
  "maxListingsPerSearch": 100,
  "listingType": "active",
  "sort": "newest",
  "condition": "any",
  "categoryId": "",
  "brand": "",
  "deltaMode": false,
  "deltaName": "",
  "alertOnNew": true,
  "alertOnPriceDrop": true,
  "minPriceDropPct": 5,
  "skipFirstRun": false,
  "includeSellerInfo": false,
  "columns": [
    "searchQuery",
    "listingType",
    "listingCount",
    "totalAvailable",
    "truncated",
    "newCount",
    "priceDropCount",
    "listings",
    "listingId",
    "url",
    "title",
    "price",
    "currency",
    "listingStatus",
    "conditionId",
    "conditionName",
    "conditionNameJa",
    "category",
    "brand",
    "sellerType",
    "shippingPaidBy",
    "isAuction",
    "auctionEndsAt",
    "postedAt",
    "updatedAt",
    "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"
  },
  "listingType": {
    "label": "Listing type (active / sold / all)",
    "format": "string"
  },
  "listingCount": {
    "label": "Listings returned",
    "format": "number"
  },
  "totalAvailable": {
    "label": "Total matching on Mercari (capped at 15,000)",
    "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": "Mercari item ID",
    "format": "string"
  },
  "url": {
    "label": "Listing link",
    "format": "string"
  },
  "title": {
    "label": "Title",
    "format": "string"
  },
  "price": {
    "label": "Price (JPY)",
    "format": "number"
  },
  "currency": {
    "label": "Currency",
    "format": "string"
  },
  "listingStatus": {
    "label": "Status (on_sale / trading / sold_out)",
    "format": "string"
  },
  "conditionId": {
    "label": "Condition ID (1 best to 6 worst)",
    "format": "number"
  },
  "conditionName": {
    "label": "Condition",
    "format": "string"
  },
  "conditionNameJa": {
    "label": "Condition (Japanese)",
    "format": "string"
  },
  "category": {
    "label": "Category ID",
    "format": "string"
  },
  "brand": {
    "label": "Brand",
    "format": "string"
  },
  "sellerType": {
    "label": "Seller type (private / Mercari Shops business)",
    "format": "string"
  },
  "shippingPaidBy": {
    "label": "Shipping paid by",
    "format": "string"
  },
  "isAuction": {
    "label": "Auction listing",
    "format": "boolean"
  },
  "auctionEndsAt": {
    "label": "Auction ends",
    "format": "string"
  },
  "postedAt": {
    "label": "Listed at",
    "format": "string"
  },
  "updatedAt": {
    "label": "Last updated (sold time for sold items)",
    "format": "string"
  },
  "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 (JPY)",
    "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 [Mercari Japan Scraper: New Listings & Sold Prices](https://apify.com/accountable_eel/mercari-jp-listing-lookup.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/accountable_eel/mercari-jp-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/mercari-jp-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`).