{"uid":"cap_tptUy4WYW0R1kgcIohWZH","slug":"china-1688-supplier-monitor-206c0b46","name":"China 1688 Supplier Monitor","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/china-1688-supplier-monitor","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"offers":{"type":"array","items":{"type":"object","required":["offerId","current","sourceName","sourceLicense"],"properties":{"current":{"type":"object","required":["offerId","title","priceMin","priceMax","currency","priceTiers","supplier"],"properties":{"moq":{"type":["number","null"],"maximum":1000000000,"minimum":0},"unit":{"type":["string","null"],"pattern":"\\S","maxLength":120,"minLength":1},"stock":{"type":["number","null"],"maximum":1000000000000,"minimum":0},"title":{"type":"string","pattern":"\\S","maxLength":500,"minLength":1},"badges":{"type":"array","items":{"type":"string","pattern":"\\S","maxLength":240,"minLength":1},"maxItems":30,"uniqueItems":true},"offerId":{"type":"string","pattern":"^[0-9]{1,80}$"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"priceMax":{"type":"number","maximum":1000000000,"minimum":0},"priceMin":{"type":"number","maximum":1000000000,"minimum":0},"supplier":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string","pattern":"\\S","maxLength":180,"minLength":1},"name":{"type":"string","pattern":"\\S","maxLength":300,"minLength":1},"loginId":{"type":["string","null"],"pattern":"\\S","maxLength":180,"minLength":1}},"additionalProperties":false},"priceTiers":{"type":"array","items":{"type":"object","required":["beginAmount","price"],"properties":{"price":{"type":"number","maximum":1000000000,"minimum":0},"beginAmount":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":50},"promotions":{"type":"array","items":{"type":"string","pattern":"\\S","maxLength":500,"minLength":1},"maxItems":30,"uniqueItems":true}},"additionalProperties":false},"offerId":{"type":"string","pattern":"^[0-9]{1,80}$"},"offerUrl":{"type":["string","null"],"pattern":"^https://detail\\.1688\\.com/offer/[0-9]+\\.html$","maxLength":500},"previous":{"type":["object","null"],"required":["offerId","title","priceMin","priceMax","currency","priceTiers","supplier"],"properties":{"moq":{"type":["number","null"],"maximum":1000000000,"minimum":0},"unit":{"type":["string","null"],"pattern":"\\S","maxLength":120,"minLength":1},"stock":{"type":["number","null"],"maximum":1000000000000,"minimum":0},"title":{"type":"string","pattern":"\\S","maxLength":500,"minLength":1},"badges":{"type":"array","items":{"type":"string","pattern":"\\S","maxLength":240,"minLength":1},"maxItems":30,"uniqueItems":true},"offerId":{"type":"string","pattern":"^[0-9]{1,80}$"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"priceMax":{"type":"number","maximum":1000000000,"minimum":0},"priceMin":{"type":"number","maximum":1000000000,"minimum":0},"supplier":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string","pattern":"\\S","maxLength":180,"minLength":1},"name":{"type":"string","pattern":"\\S","maxLength":300,"minLength":1},"loginId":{"type":["string","null"],"pattern":"\\S","maxLength":180,"minLength":1}},"additionalProperties":false},"priceTiers":{"type":"array","items":{"type":"object","required":["beginAmount","price"],"properties":{"price":{"type":"number","maximum":1000000000,"minimum":0},"beginAmount":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":50},"promotions":{"type":"array","items":{"type":"string","pattern":"\\S","maxLength":500,"minLength":1},"maxItems":30,"uniqueItems":true}},"additionalProperties":false},"sourceName":{"type":"string","pattern":"\\S","maxLength":200,"minLength":1},"sourceLicense":{"type":"string","pattern":"\\S","maxLength":700,"minLength":1},"sourceRetrievedAt":{"type":["string","null"],"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,9})?Z$","maxLength":40}},"additionalProperties":false},"maxItems":50,"minItems":1},"watchName":{"type":"string","pattern":"^[^\\u0000-\\u001F\\u007F-\\u009F]*\\S[^\\u0000-\\u001F\\u007F-\\u009F]*$","maxLength":80,"minLength":1},"maxChanges":{"type":"integer","maximum":50,"minimum":1},"productUrls":{"type":"array","items":{"type":"string","pattern":"\\S","maxLength":500,"minLength":1},"maxItems":50,"minItems":1},"authorization":{"enum":["I confirm I am authorized to process and deliver these 1688 offer records"],"type":"string"},"schemaVersion":{"enum":["2.0"],"type":"string"},"sourceContext":{"enum":["buyer_owned_1688_export","merchant_authorized_1688_export","licensed_1688_integration","other_licensed_wholesale_export"],"type":"string"},"proxyConfiguration":{"type":"object"}}},"responseSchema":{"type":"json","example":{"meta":{"run_ms":1200,"settled":true,"item_count":1},"results":[{"error":"","found":true,"isDemo":false,"source":"1688","current":{"moq":10,"unit":"件","stock":8000,"title":"Example wholesale offer","badges":[],"offerId":"1000406623486","currency":"CNY","priceMax":5.2,"priceMin":4.5,"supplier":{"id":"b2b-example","name":"Example Supplier","loginId":"example"},"priceTiers":[{"price":5.2,"beginAmount":10},{"price":4.5,"beginAmount":100}],"promotions":[]},"partial":false,"previous":{"offerId":"1000406623486","priceMin":4.8},"targetId":"1000406623486","checkedAt":"2026-08-06T05:00:00.000Z","targetUrl":"https://detail.1688.com/offer/1000406623486.html","watchName":"main-supplier-watch","changeType":"changed","evidenceUrl":"https://m.1688.com/offer/1000406623486.html","changedFields":["priceMin","priceTiers","promotions"],"partialReason":""}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uDdcy20n0XlilspsO6JwC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Monitors a 1688.com wholesale supplier offer for price, MOQ, stock, and promotion changes and returns current vs. previous state with a diff of changed fields","exampleAgentPrompt":"Check my 1688 supplier watch called 'main-supplier-watch' for offer ID 1000406623486 and tell me if the price, MOQ, or promotions have changed since the last time we checked.","exampleUseCases":[{"title":"Wholesale price drop alert","prompt":"Keep an eye on offer 1000406623486 on 1688 — let me know the moment the priceMin drops below 4.0 CNY or any new promotions appear. The watch name is 'electronics-bulk-watch'."},{"title":"MOQ threshold sourcing check","prompt":"I'm about to place a bulk order — can you check 1688 offer 1000406623486 via my 'main-supplier-watch' and confirm what the current minimum order quantity and price tiers are right now?"},{"title":"Competitor sourcing intelligence","prompt":"Pull the latest state of 1688 offer 1000406623486 using the watch 'comp-monitor' and show me what fields have changed compared to the previous snapshot so I can see if our competitor's supplier updated their terms."}],"resultDescription":"Returns a JSON object with meta (run time, item count, settlement status) and a results array containing the current offer state (price tiers, MOQ, stock, title, supplier details, promotions, currency), the previous snapshot (prior priceMin and offerId), a list of changedFields, a changeType flag, timestamps, and an evidence URL linking directly to the 1688 offer page.","failureModes":["Offer ID not found on 1688 — returns found:false with an error message","Partial data retrieval — partial:true with partialReason explaining what was incomplete","Network or scrape timeout — run_ms may be high and results may be empty","Demo mode fallback — isDemo:true if live data unavailable, returning synthetic example data","Payment not settled — settled:false if x402 micropayment failed"],"whenToPreferThis":"Choose this endpoint when you need real-time change detection on a specific 1688.com wholesale offer rather than a broad product search. It is ideal for supply chain agents that need to detect price drift, MOQ changes, or new promotions on a known supplier listing, especially when you already have an offer ID and want a structured diff between current and previous state. It is not suited for discovering new suppliers or searching 1688 by keyword.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:53:36.714Z","isFirstParty":false}