# 1688 API

用商品词或 offerId 查找 1688 批发货源，读取起订量、阶梯价和 SKU 规格；价格须结合采购数量核对，不是含运费的成交报价。

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

## Actions

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

- Optional: city, max_price, min_price, sort
- Allowed values: sort (popular/price_asc/price_desc/relevance)

- Returns fields: id, url, title, text, price_min, price_max, currency, min_order_quantity, order_count, repurchase_rate, category, city, province, supplier_name, is_out_of_stock, supports_dropship, images, supplier_type, supplier_years, supplier_shop_url, supplier_composite_score, sold_count_text, service_tags, product_badges, rating, rating_scale, review_count, positive_rate, sold_count, sold_display, want_buy_count, stock, unit, category_path, video_url, winport_url, supplier_fans, supplier_founded_year, price_tiers, specs, description_images, coupons, promotion_details, service_details, purchase_limits, mix_wholesale, supports_mix, review_tags, refund_rate, review_negative_count, review_neutral_count, review_with_photo_count, review_with_text_count, supplier_stats, supplier_scores, supplier_metric_tags, supplier_rank, supplier_industry_belt, supplier_certification, supplier_verification_tags, supplier_inspection_report_url, supplier_videos, supplier_address, supplier_coordinates, supplier_main_category, customization, shipping, unit_weight_kg, platform

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

- Returns fields: id, url, title, text, price_min, price_max, currency, price_tiers, min_order_quantity, stock, sold_count, category, unit, supplier_name, supplier_fans, supplier_founded_year, supplier_type, supplier_favorited_count, supports_dropship, supports_sampling, is_out_of_stock, skus, images, description_images, video_url, specs, rating, rating_scale, review_count, positive_rate, sold_display, want_buy_count, category_path, services, promotions, customization_supported, winport_url, city, province, supplier_years, package_dimensions, coupons, promotion_details, service_details, purchase_limits, mix_wholesale, supports_mix, review_tags, refund_rate, review_negative_count, review_neutral_count, review_with_photo_count, review_with_text_count, supplier_stats, supplier_scores, supplier_metric_tags, supplier_rank, supplier_industry_belt, supplier_certification, supplier_verification_tags, supplier_inspection_report_url, supplier_videos, supplier_address, supplier_coordinates, supplier_main_category, customization, shipping, unit_weight_kg, platform

### image_search — 平台内商品图搜
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: image_url

- Returns fields: id, url, title, price, currency, min_order_quantity, order_count, supplier_name, image_url, rank, platform

## Also

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