{"repo":"zhu-kai/mercapi-node","free":true,"listed":false,"github":"https://github.com/zhu-kai/mercapi-node","clone":"git clone https://github.com/zhu-kai/mercapi-node.git","description":"TypeScript client for the Mercari Japan API (Node.js port of mercapi)","language":"TypeScript","stars":26,"topics":["api-client","mercari","nodejs","typescript"],"license":null,"category":"api-integrations-sdks","readme_excerpt":"mercapi-node Live API status: zhu-kai.github.io/mercapi-node — a scheduled check runs every 6 hours against the real Mercari API and fails loudly if the API changes. Node.js client for Mercari Japan API. TypeScript-first, serverless-friendly. This project is derived from mercapi by Take-kun. Disclaimer: This is an unofficial library. Use at your own risk. Features - Full TypeScript support with type definitions - Covers search, item details, sellers, reviews, similar items, Mercari Shops products, search autocomplete, seller badges, and master data - Serverless-optimized (fresh keys per request by default) - No heavy dependencies (only jose for JWT signing) - ESM and CommonJS support - Node.js 18+ (uses native fetch) Installation Quick Start Usage Patterns Pattern 1: Static Methods (Simplest) Best for serverless. Each call uses fresh keys automatically. Pattern 2: Instance with Fresh Keys (Default) Pattern 3: Instance with Key Reuse For batched requests where you want to reuse keys: API Reference search(query, options?) Search for items on Mercari. Options Option Type Default Description ------------------ -------------- ---------- --------------------------- categories number[] Category IDs brands number[] Brand IDs sizes number[] Size IDs priceMin number Minimum price (JPY) priceMax number Maximum price (JPY) itemConditions number[] Condition IDs (1-6) shippingPayer number[] 1=buyer, 2=seller colors number[] Color IDs (1-12) status ItemStatus[] [OnSale] OnSale , SoldOut sor","default_branch":null,"files":null,"tree":[],"storefront":"/r/zhu-kai","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/zhu-kai/mercapi-node/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}