{"endpoints":{"/affiliate-hotproducts":{"content_types":["application/json","application/x-www-form-urlencoded","query parameters"],"description":"Query AliExpress affiliate hot/trending products","example":{"category_ids":"200000345","page_size":50,"sort":"LAST_VOLUME_DESC","target_currency":"USD"},"method":"GET/POST","note":"Returns hot/trending products with high sales volume and commission rates. Includes hot_product_commission_rate field. No OAuth required.","parameters":{"app_signature":"Optional: Application signature (default: aaaaa)","category_ids":"Optional: Category IDs (comma-separated or array)","delivery_days":"Optional: Delivery days filter","fields":"Optional: Fields to retrieve (comma-separated)","keywords":"Optional: Search keywords","max_sale_price":"Optional: Maximum sale price","min_sale_price":"Optional: Minimum sale price","page_no":"Optional: Page number (default: 1)","page_size":"Optional: Results per page (default: 50, max: 50)","platform_product_type":"Optional: Product type - ALL, PLAZA, TMALL (default: ALL)","promotion_name":"Optional: Promotion name","ship_to_country":"Optional: Ship to country code (default: US)","sort":"Optional: Sort option - SALE_PRICE_ASC, SALE_PRICE_DESC, LAST_VOLUME_ASC, LAST_VOLUME_DESC","target_currency":"Optional: Currency code (default: USD)","target_language":"Optional: Language code (default: EN)","tracking_id":"Optional: Tracking ID for affiliate tracking"}},"/affiliate_category":{"content_types":["application/json","application/x-www-form-urlencoded","query parameters"],"description":"Get AliExpress affiliate category information with optional filtering","example":{"all_categories":{"app_signature":"aaaaa"},"filtered":{"parent_category_id":"200000345"}},"method":"GET/POST","note":"Returns all affiliate categories if no parent_category_id specified, or filtered categories if parent_category_id is provided. No authentication required - uses affiliate API credentials.","parameters":{"app_signature":"Optional: Application signature (default: aaaaa)","parent_category_id":"Optional: Filter by parent category ID (e.g., 200000345 for Women's Clothing)"}},"/affiliate_search":{"content_types":["application/json","application/x-www-form-urlencoded","query parameters"],"description":"Search AliExpress affiliate products with advanced filters","example":{"category_ids":"111,222","keywords":"laptop","max_sale_price":"500","min_sale_price":"50","page_size":20,"sort":"SALE_PRICE_ASC","target_currency":"USD"},"method":"GET/POST","note":"Returns products with affiliate promotion links and commission rates. No OAuth required.","parameters":{"app_signature":"Optional: Application signature (default: aaaaa)","category_ids":"Optional: Category IDs (comma-separated or array)","delivery_days":"Optional: Delivery days filter","fields":"Optional: Fields to retrieve (comma-separated)","keywords":"Optional: Search keywords","max_sale_price":"Optional: Maximum sale price","min_sale_price":"Optional: Minimum sale price","page_no":"Optional: Page number (default: 1)","page_size":"Optional: Results per page (default: 50, max: 50)","platform_product_type":"Optional: Product type - ALL, PLAZA, TMALL (default: ALL)","promotion_name":"Optional: Promotion name","ship_to_country":"Optional: Ship to country code (default: US)","sort":"Optional: Sort option - SALE_PRICE_ASC, SALE_PRICE_DESC, LAST_VOLUME_ASC, LAST_VOLUME_DESC","target_currency":"Optional: Currency code (default: USD)","target_language":"Optional: Language code (default: EN)","tracking_id":"Optional: Tracking ID for affiliate tracking"}},"/aliexpress_cb":{"description":"OAuth callback endpoint for AliExpress authentication","method":"GET","parameters":{"code":"Required: Authorization code from AliExpress OAuth flow"},"response":{"access_token":"Generated access token","expires_in":"Token expiration time in seconds","expiry_time":"ISO format expiry timestamp","refresh_token":"Refresh token (if provided)","success":true}},"/cat_women_clothing":{"content_types":["application/json","application/x-www-form-urlencoded","query parameters"],"description":"Convenience endpoint for Women's Clothing sub-categories","example":{"app_signature":"aaaaa"},"method":"GET/POST","note":"Convenience wrapper - equivalent to /affiliate_category?parent_category_id=200000345. Returns Women's Clothing sub-categories.","parameters":{"app_signature":"Optional: Application signature (default: aaaaa)"}},"/category":{"content_types":["application/json","application/x-www-form-urlencoded","query parameters"],"description":"Get AliExpress DS category information and hierarchy","example":{"category_id":"15","language":"en"},"method":"GET/POST","note":"Returns category ID, name, and parent category info. Useful for building category trees.","parameters":{"app_signature":"Optional: Application signature (default: aaaaa)","category_id":"Optional: Category ID to query (returns root categories if not provided)","language":"Optional: Language code (default: en) - Supported: hi, de, ru, pt, ko, in, en, it, fr, zh, es, iw, ar, vi, th, uk, ja, id, pl, he, nl, tr"}},"/ds-product-details":{"content_type":"application/json","description":"Get dropshipping product details by product ID","example":{"product_id":"1005003784285827","ship_to_country":"US","target_currency":"USD"},"method":"POST","parameters":{"biz_model":"Optional: Business model","city_code":"Optional: City code","product_id":"Required: Product ID","province_code":"Optional: Province code","remove_personal_benefit":"Optional: Remove personal benefit (true/false)","ship_to_country":"Optional: Ship to country code (default: US)","target_currency":"Optional: Target currency (default: USD)","target_language":"Optional: Target language (default: en)"}},"/ds_search":{"content_types":["application/json","application/x-www-form-urlencoded","query parameters"],"description":"Search products on AliExpress DS using text/keyword","example":{"category_id":"349","country_code":"US","currency":"USD","keyword":"dress","local":"en_US","page_index":1,"page_size":20,"sort_by":"min_price,asc"},"method":"GET/POST","parameters":{"category_id":"Optional: Category ID to filter results","country_code":"Required: Ship to country code (e.g., US, CN) - default: US","currency":"Required: Currency code (e.g., USD, EUR) - default: USD","keyword":"Optional: Search query/keyword","local":"Required: Language code (e.g., en_US, zh_CN) - default: en_US","page_index":"Optional: Page number (default: 1)","page_size":"Optional: Number of results per page (default: 20)","search_extend":"Optional: Search extend parameters (JSON array)","selection_name":"Optional: Search within specific selection","sort_by":"Optional: Sort option (min_price,asc | min_price,desc | orders,asc | orders,desc | comments,asc | comments,desc)"}},"/health":{"description":"Health check endpoint","method":"GET"},"/product-details":{"content_type":"application/json","description":"Get detailed product information by product IDs","example":{"product_ids":["1005006387330813","1005005755309294"],"target_currency":"USD","target_language":"EN"},"method":"POST","parameters":{"app_signature":"Optional: app signature (default: aaaaa)","country":"Optional: country code (default: US)","fields":"Optional: Comma-separated fields to retrieve","product_ids":"Required: Array of product IDs to query","target_currency":"Optional: currency code (default: USD)","target_language":"Optional: language code (default: EN)"}},"/search-image":{"content_types":["multipart/form-data","application/json"],"description":"Search products using image with affiliate promotion links for monetization","method":"POST","note":"Returns enhanced results with promotion_link and commission_rate for monetization","parameters":{"currency":"Optional: currency code (default: USD)","image":"Image file (for multipart/form-data)","image_base64":"Base64 encoded image (for application/json)","lang":"Optional: language code (default: en)","search_type":"Optional: same/similar (default: similar)","ship_to":"Optional: country code (default: US)","sort_order":"Optional: asc/desc (default: asc)","sort_type":"Optional: price/orders (default: price)"}},"/search-image-original":{"content_types":["multipart/form-data","application/json"],"description":"Search products on AliExpress using image","method":"POST","parameters":{"currency":"Optional: currency code (default: USD)","image":"Image file (for multipart/form-data)","image_base64":"Base64 encoded image (for application/json)","include_affiliate_links":"Optional: true/false to include promotion links (default: false)","lang":"Optional: language code (default: en)","search_type":"Optional: same/similar (default: similar)","ship_to":"Optional: country code (default: US)","sort_order":"Optional: asc/desc (default: asc)","sort_type":"Optional: price/orders (default: price)"}}},"message":"AliExpress API - Image Search, Text Search, Categories & Product Details."}