1688 API 接入教程：用 Python 搜索商品并获取详情

python3 -m pip install requests
export JUSTONEAPI_TOKEN='your_token'

import argparse
import json
import os
from datetime import datetime, timezone
from pathlib import Path

import requests


def main():
    parser = argparse.ArgumentParser()
    parser.add_argument("mode", choices=("search", "detail"))
    parser.add_argument("--keyword")
    parser.add_argument("--item-id")
    parser.add_argument("--output", required=True)
    args = parser.parse_args()
    if args.mode == "search" and not (args.keyword or "").strip():
        parser.error("search requires --keyword")
    if args.mode == "detail" and not (args.item_id or "").strip():
        parser.error("detail requires --item-id")
    output = Path(args.output)
    if output.exists() or not output.parent.is_dir():
        raise SystemExit("Use a new output filename in an existing folder.")
    token = os.environ.get("JUSTONEAPI_TOKEN", "").strip()
    if not token or token == "your_token":
        raise SystemExit("Set JUSTONEAPI_TOKEN to your own API token.")
    if args.mode == "search":
        path = "/api/1688/search-item-list/v2"
        params = {"keyword": args.keyword, "page": 1,
                  "pageSize": 10, "sort": "price_up"}
    else:
        path = "/api/1688/get-item-detail/v2"
        params = {"itemId": args.item_id, "language": "en"}
    try:
        response = requests.get("https://api.justoneapi.com" + path,
                                params={**params, "token": token},
                                timeout=120, allow_redirects=False)
    except requests.RequestException:
        raise SystemExit("No confirmed result. No automatic retry was made; "
                         "check request records before repeating.") from None
    try:
        payload = response.json()
    except ValueError:
        raise SystemExit("Expected a JSON response; no result file was saved.") from None
    if response.status_code != 200:
        raise SystemExit(f"HTTP {response.status_code}; no result file was saved.")
    if not isinstance(payload, dict):
        raise SystemExit("Unexpected response structure; inspect the documentation.")
    code = payload.get("code")
    if type(code) is not int or code != 0:
        label = str(code) if type(code) is int else "missing/invalid"
        raise SystemExit(f"Business code {label}; no result file was saved.")
    if "data" not in payload:
        raise SystemExit("Success envelope has no data field; inspect the documentation.")
    result = {"collected_at_utc": datetime.now(timezone.utc).isoformat(),
              "endpoint": path, "data": payload["data"]}
    with output.open("x", encoding="utf-8") as file:
        json.dump(result, file, ensure_ascii=False, indent=2)
    print(f"Saved {output.name}")


if __name__ == "__main__":
    main()

python3 1688_sample.py search --keyword '保温杯' --output search.json

python3 1688_sample.py detail --item-id YOUR_ITEM_ID --output detail.json