淘宝/天猫商品数据怎么获取？商品搜索、详情与评价 API 教程

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

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

import requests

BASE_URL = "https://api.justoneapi.com"
TOKEN = os.environ.get("JUSTONEAPI_TOKEN", "")


def call_api(path, method="GET", accepted_codes=(0,), **params):
    if not TOKEN or TOKEN == "your_token":
        raise RuntimeError("Set JUSTONEAPI_TOKEN before running")
    values = {"token": TOKEN, **params}
    arguments = {"data": values} if method == "POST" else {"params": values}
    try:
        response = requests.request(
            method, BASE_URL + path, timeout=120, **arguments,
        )
    except requests.RequestException:
        raise RuntimeError("Network error or timeout") from None
    if response.status_code != 200:
        raise RuntimeError(f"HTTP {response.status_code}")
    try:
        result = response.json()
    except ValueError:
        raise RuntimeError("Response is not valid JSON") from None
    if not isinstance(result, dict) or result.get("code") not in accepted_codes:
        code = result.get("code") if isinstance(result, dict) else None
        raise RuntimeError(f"API failed: code={code}; check the docs")
    return result


def output_dir(prefix):
    stamp = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%S%fZ")
    folder = Path(prefix) / stamp
    folder.mkdir(parents=True, exist_ok=False)
    return folder


def save_json(folder, filename, value):
    (folder / filename).write_text(
        json.dumps(value, ensure_ascii=False, indent=2), encoding="utf-8",
    )


KEYWORD = "保温杯"
MAX_PRODUCTS = 3
MAX_REVIEW_PAGES = 2


def main():
    folder = output_dir("taobao-output")
    search = call_api(
        "/api/taobao/search-item-list/v1",
        keyword=KEYWORD, page=1, sort="_sale", tmall="false",
        startPrice="30", endPrice="100",
    )
    save_json(folder, "search-1.json", search)
    items = (search["data"].get("model") or {}).get("itemList") or []
    item_ids = list(dict.fromkeys(
        str(item["itemId"]) for item in items if item.get("itemId")
    ))[:MAX_PRODUCTS]
    save_json(folder, "selected-item-ids.json", item_ids)

    for index, item_id in enumerate(item_ids, start=1):
        detail = call_api("/api/taobao/get-item-detail/v6", itemId=item_id)
        save_json(folder, f"item-{index}-detail.json", detail)
        for page in range(1, MAX_REVIEW_PAGES + 1):
            reviews = call_api(
                "/api/taobao/get-item-comment/v3",
                itemId=item_id, orderType="feedbackdate", page=page,
            )
            save_json(folder, f"item-{index}-reviews-{page}.json", reviews)
            if reviews["data"].get("hasNextPage") not in (True, 1, "1"):
                break
    print(f"Saved {len(item_ids)} product samples to {folder}")


if __name__ == "__main__":
    try:
        main()
    except RuntimeError as error:
        raise SystemExit(str(error)) from None