timzinin-com China 1688 Supplier Monitor API
The China 1688 Supplier Monitor API from timzinin-com — 1 operation(s) for china 1688 supplier monitor.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/timzinin-com:timzinin-com-china-1688-supplier-monitor-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Zinin M2M Hub China 1688 Supplier Monitor API
description: Pay-per-call data & tool APIs
version: 1.0.0
x-guidance: 'Zinin M2M Hub — pay-per-call data & tool APIs for AI agents. Each POST /api/{slug} operation below is a distinct paid tool: call GET /api/{slug}/schema first for the exact input shape, then POST with a signed PAYMENT-SIGNATURE header (x402 v2, USDC — see x-payment-info per operation) or omit it to receive a 402 with full payment requirements in the PAYMENT-REQUIRED header. The same catalog is also available as MCP JSON-RPC tool bundles at POST /mcp/{bundle} — see GET /.well-known/x402 for the list of bundles.'
tags:
- name: China 1688 Supplier Monitor
paths:
/api/china-1688-supplier-monitor:
post:
summary: 1688 Supplier Price & MOQ Monitor
description: Compare buyer-owned, merchant-authorized, or licensed 1688 offer exports for price, MOQ, stock, supplier, badge, and promotion changes. Each delivered row adds stable identity, freshness, evidence gaps, review priority, and a human action—with no 1688 login, scraping, API call, or URL fetch.
operationId: call_china_1688_supplier_monitor
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.020000'
protocols:
- x402: {}
network: eip155:8453
payTo: '0x409D32aD39C02BC9B23a8b2d447532ed801b12dE'
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
requestBody:
required: true
content:
application/json:
schema:
title: Authorized 1688 offer comparison input
description: Submit buyer-owned, merchant-authorized, or licensed 1688 previous/current offer snapshots. The Actor makes no source request. Runtime requires either offers with authorization and sourceContext, or legacy productUrls alone; the official Actor schema validator does not support that root one-of condition. Legacy productUrls stay accepted only as a free migration diagnostic.
type: object
schemaVersion: 1
additionalProperties: false
required:
- watchName
properties:
schemaVersion:
title: Contract version
description: Closed public input contract version.
type: string
enum:
- '2.0'
default: '2.0'
editor: select
authorization:
title: Authorization confirmation
description: Required for offers. This is a buyer attestation, not independent verification by the Actor.
type: string
enum:
- I confirm I am authorized to process and deliver these 1688 offer records
editor: select
sourceContext:
title: Source context
description: Required buyer-attested origin category for the authorized export.
type: string
enum:
- buyer_owned_1688_export
- merchant_authorized_1688_export
- licensed_1688_integration
- other_licensed_wholesale_export
editor: select
watchName:
title: Watch name
description: Stable buyer label for this comparison. It is returned in every row and OUTPUT receipt; the Actor does not persist a cross-run source baseline.
type: string
minLength: 1
maxLength: 80
pattern: ^[^\u0000-\u001F\u007F-\u009F]*\S[^\u0000-\u001F\u007F-\u009F]*$
default: main-supplier-watch
editor: textfield
offers:
title: Authorized 1688 offer records
description: One to 50 closed previous/current records. Unknown or malformed records are counted invalid. Duplicate offerId values are delivered once.
type: array
minItems: 1
maxItems: 50
editor: json
prefill:
- offerId: '1000406623486'
offerUrl: https://detail.1688.com/offer/1000406623486.html
previous:
offerId: '1000406623486'
title: USB-C cable wholesale pack
priceMin: 3.8
priceMax: 4.6
currency: CNY
priceTiers:
- beginAmount: 100
price: 4.6
- beginAmount: 500
price: 3.8
moq: 100
stock: 12000
unit: piece
supplier:
id: supplier-88
name: Example Authorized Supplier
loginId: seller88
badges:
- verified-export
promotions: []
current:
offerId: '1000406623486'
title: USB-C cable wholesale pack
priceMin: 3.6
priceMax: 4.4
currency: CNY
priceTiers:
- beginAmount: 100
price: 4.4
- beginAmount: 500
price: 3.6
moq: 100
stock: 15000
unit: piece
supplier:
id: supplier-88
name: Example Authorized Supplier
loginId: seller88
badges:
- verified-export
promotions:
- buyer-supplied summer tier
sourceName: Buyer-owned 1688 export
sourceLicense: Buyer confirms authorization to process and deliver this export.
sourceRetrievedAt: '2026-08-13T00:00:00Z'
items:
type: object
additionalProperties: false
required:
- offerId
- current
- sourceName
- sourceLicense
properties:
offerId:
title: Offer ID
description: Stable numeric 1688 offer identity.
type: string
pattern: ^[0-9]{1,80}$
offerUrl:
title: Recorded offer URL
description: Optional exact detail.1688.com offer reference; recorded but never fetched.
type: string
nullable: true
maxLength: 500
pattern: ^https://detail\.1688\.com/offer/[0-9]+\.html$
previous:
title: Previous authorized snapshot
description: Optional previous snapshot from the buyer's own history. Null means baseline_created.
type: object
nullable: true
editor: json
additionalProperties: false
required:
- offerId
- title
- priceMin
- priceMax
- currency
- priceTiers
- supplier
properties:
offerId:
title: Offer Id
description: Buyer-supplied offer id for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
pattern: ^[0-9]{1,80}$
title:
title: Title
description: Buyer-supplied title for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
minLength: 1
maxLength: 500
pattern: \S
priceMin:
title: Price Min
description: Buyer-supplied price min for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
minimum: 0
maximum: 1000000000
priceMax:
title: Price Max
description: Buyer-supplied price max for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
minimum: 0
maximum: 1000000000
currency:
title: Currency
description: Buyer-supplied currency for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
pattern: ^[A-Za-z]{3}$
priceTiers:
title: Price Tiers
description: Buyer-supplied price tiers for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: array
maxItems: 50
items:
type: object
additionalProperties: false
required:
- beginAmount
- price
properties:
beginAmount:
title: Begin Amount
description: Buyer-supplied begin amount for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
minimum: 0
maximum: 1000000000
price:
title: Price
description: Buyer-supplied price for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
minimum: 0
maximum: 1000000000
moq:
title: Moq
description: Buyer-supplied moq for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
nullable: true
minimum: 0
maximum: 1000000000
stock:
title: Stock
description: Buyer-supplied stock for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
nullable: true
minimum: 0
maximum: 1000000000000
unit:
title: Unit
description: Buyer-supplied unit for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
nullable: true
minLength: 1
maxLength: 120
pattern: \S
supplier:
title: Supplier
description: Buyer-supplied supplier for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: object
additionalProperties: false
required:
- id
- name
properties:
id:
title: Id
description: Buyer-supplied id for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
minLength: 1
maxLength: 180
pattern: \S
name:
title: Name
description: Buyer-supplied name for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
minLength: 1
maxLength: 300
pattern: \S
loginId:
title: Login Id
description: Buyer-supplied login id for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
nullable: true
minLength: 1
maxLength: 180
pattern: \S
badges:
title: Badges
description: Buyer-supplied badges for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: array
maxItems: 30
uniqueItems: true
items:
type: string
minLength: 1
maxLength: 240
pattern: \S
promotions:
title: Promotions
description: Buyer-supplied promotions for the previous authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: array
maxItems: 30
uniqueItems: true
items:
type: string
minLength: 1
maxLength: 500
pattern: \S
current:
title: Current authorized snapshot
description: Required current snapshot from the authorized export.
type: object
editor: json
additionalProperties: false
required:
- offerId
- title
- priceMin
- priceMax
- currency
- priceTiers
- supplier
properties:
offerId:
title: Offer Id
description: Buyer-supplied offer id for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
pattern: ^[0-9]{1,80}$
title:
title: Title
description: Buyer-supplied title for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
minLength: 1
maxLength: 500
pattern: \S
priceMin:
title: Price Min
description: Buyer-supplied price min for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
minimum: 0
maximum: 1000000000
priceMax:
title: Price Max
description: Buyer-supplied price max for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
minimum: 0
maximum: 1000000000
currency:
title: Currency
description: Buyer-supplied currency for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
pattern: ^[A-Za-z]{3}$
priceTiers:
title: Price Tiers
description: Buyer-supplied price tiers for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: array
maxItems: 50
items:
type: object
additionalProperties: false
required:
- beginAmount
- price
properties:
beginAmount:
title: Begin Amount
description: Buyer-supplied begin amount for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
minimum: 0
maximum: 1000000000
price:
title: Price
description: Buyer-supplied price for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
minimum: 0
maximum: 1000000000
moq:
title: Moq
description: Buyer-supplied moq for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
nullable: true
minimum: 0
maximum: 1000000000
stock:
title: Stock
description: Buyer-supplied stock for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: number
nullable: true
minimum: 0
maximum: 1000000000000
unit:
title: Unit
description: Buyer-supplied unit for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
nullable: true
minLength: 1
maxLength: 120
pattern: \S
supplier:
title: Supplier
description: Buyer-supplied supplier for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: object
additionalProperties: false
required:
- id
- name
properties:
id:
title: Id
description: Buyer-supplied id for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
minLength: 1
maxLength: 180
pattern: \S
name:
title: Name
description: Buyer-supplied name for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
minLength: 1
maxLength: 300
pattern: \S
loginId:
title: Login Id
description: Buyer-supplied login id for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: string
nullable: true
minLength: 1
maxLength: 180
pattern: \S
badges:
title: Badges
description: Buyer-supplied badges for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: array
maxItems: 30
uniqueItems: true
items:
type: string
minLength: 1
maxLength: 240
pattern: \S
promotions:
title: Promotions
description: Buyer-supplied promotions for the current authorized offer snapshot; recorded as submitted and not independently verified by the Actor.
type: array
maxItems: 30
uniqueItems: true
items:
type: string
minLength: 1
maxLength: 500
pattern: \S
sourceName:
title: Authorized source label
description: Traceable buyer-supplied label for the export or licensed integration.
type: string
minLength: 1
maxLength: 200
pattern: \S
sourceLicense:
title: Rights statement
description: Buyer-supplied processing and downstream delivery rights statement; recorded but not independently verified.
type: string
minLength: 1
maxLength: 700
pattern: \S
sourceRetrievedAt:
title: Source retrieved at
description: Optional UTC time when the authorized export was obtained.
type: string
nullable: true
maxLength: 40
pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?Z$
productUrls:
title: Legacy 1688 product URLs
description: Migration-only legacy input. URLs are never fetched and produce one free diagnostic row.
type: array
minItems: 1
maxItems: 50
items:
type: string
minLength: 1
maxLength: 500
pattern: \S
editor: stringList
maxChanges:
title: Maximum changed rows
description: Stop before delivering more changed comparisons after this count. Baseline/no-change rows already delivered still count as paid rows.
type: integer
minimum: 1
maximum: 50
default: 20
editor: number
proxyConfiguration:
title: Legacy proxy configuration
description: Accepted only for backward compatibility and ignored. The current Actor makes zero network requests.
type: object
editor: proxy
responses:
'200':
description: Actor run succeeded and payment settled
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
type: object
description: Actor output items — shape is actor-specific (varies per tool); see this operation's own requestBody schema/description for what the underlying actor produces.
meta:
type: object
properties:
run_ms:
type: integer
description: Actor run duration in milliseconds
item_count:
type: integer
description: len(results)
settled:
type: boolean
description: Whether the x402 payment was confirmed settled by the facilitator
transaction:
type:
- string
- 'null'
description: On-chain settlement transaction hash, null if unsettled
required:
- run_ms
- item_count
- settled
- transaction
required:
- results
- meta
'400':
description: Malformed PAYMENT-SIGNATURE header or request body
'402':
description: Payment required or invalid — see PAYMENT-REQUIRED header
'409':
description: Payment payload already used
'502':
description: Actor run failed
'504':
description: Actor run timed out
tags:
- China 1688 Supplier Monitor