# 淘宝 API

搜索淘宝与天猫商品，按商品或卖家标识查看单品规格和店铺商品列表，再分别读取评价与“问大家”，便于核对购买规格、反馈和购买前疑问。

- Domain: ecom · 5 data actions
- Canonical page: https://everyinfra.com/taobao-api
- Failures and empty results never form a final charge.

## Actions

### search — 关键词搜索
- Mode: sync · Price: 972 credits ($13.5 / 千次)
- Required: keyword

- Optional: max_price, min_price, page, sort, tmall_only
- Allowed values: sort (popular/price_desc/relevance)

- Returns fields: id, url, title, price, currency, price_basis, sold_count, rating, rating_scale, location, shop_name, image_url, stock, shop_id, sold_text, original_price, coupon_price, discount_type, is_tmall, brand, category_id, seller_credit_level, seller_positive_rate, shop_score_description, shop_score_service, shop_score_delivery, subtitle, search_rank, free_shipping, selling_points, review_tags, images, discount_rate, spu_id, category_path, review_count, latest_review, seller_type, shop_opened_at, shop_age_years, shop_item_count, shop_score_vs_industry, platform

### product_detail — 商品详情
- Mode: sync · Price: 324 credits ($4.5 / 千次)
- Required: url

- Returns fields: id, url, title, brand, price, original_price, currency, price_basis, stock, sold_count, category_id, location, is_tmall, shop_name, shop_id, shipping_fee, ems_fee, express_fee, skus, sku_count, spec_values, props_images, attributes, main_image_url, description_images, description_html, video_url, coupon_price, price_usd, total_price, suggestive_price, has_discount, is_promotion, promo_type, is_virtual, brand_id, root_category_id, category_path, weight, size, favorite_count, fans_count, min_order_quantity, shipping_to, listed_at, modified_at, delist_at, images, category_name, description, keywords, titleOriginal, has_cn_title, shop_score_description, shop_score_service, shop_score_delivery, free_shipping, promotion_price, discount_price, discount_type, price_note, has_price_range, payment_methods, seller_id, seller_credit_level, seller_type, seller_type_label, selling_points, shop_logo_url, shop_url, shop_item_count, shop_new_item_count, shop_opened_at, review_tags, review_count, positive_rate, seven_day_return, reviews, platform

### shop — 店铺资料
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: shop

- Optional: page, seller, sort, user_id
- Allowed values: sort (best_selling/highest_price/lowest_price/new/newly_listed/popular/price_asc/price_desc/…)

- Returns fields: id, url, title, original_price, currency, category_id, free_shipping, shop_name, shop_id, seller_id, image_url, shop_url, shop_logo_url, shop_score_description, shop_score_service, shop_score_delivery, shop_item_count, platform

### reviews — 评价
- Mode: sync · Price: 100 credits ($1.39 / 千次) per 20 rows asked
- Required: url

- Optional: page, page_token

- Returns fields: id, text, rating, rating_scale, posted_at, sku, buy_count, useful_count, author_name, author_avatar_url, images, review_append, platform, next_page_token, seller_reply

### questions — 问题列表
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, url, text, answer_count, posted_at, answers, platform

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md