{ "openapi": "3.0.1", "info": { "title": "Alibaba Scraper - Products & Verified Suppliers", "description": "Scrape Alibaba products with tiered pricing, MOQ, specs, SKUs, certifications, and the verified manufacturer behind each. Browse a whole category or search by keyword. Add store reviews and full supplier verification reports. Filter by category, country, and price. Export to JSON, CSV, Excel.", "version": "0.0", "x-build-id": "qqV5qwZ1CEaSEyNP7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~alibaba-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-alibaba-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/zen-studio~alibaba-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-alibaba-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/zen-studio~alibaba-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-alibaba-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "resultType": { "title": "What to scrape", "enum": [ "products", "suppliers", "category" ], "type": "string", "description": "Products: product listings with the supplier behind each.
Suppliers: manufacturer/factory profiles.
Category: browse every product in a chosen category (no keyword needed).", "default": "products" }, "keywords": { "title": "Search keywords 🔍", "type": "array", "description": "What to search for, e.g. led lights, cnc machine. Each keyword is searched separately; Max results applies per keyword.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "Agriculture, Food & Beverage", "Apparel & Accessories", "Automotive Supplies & Tools", "Beauty", "Commercial Equipment & Machinery", "Construction & Building Machinery", "Construction & Real Estate", "Consumer Electronics", "Electrical Equipment & Supplies", "Electronic Components", "Fabrication Services", "Furniture", "Gifts & Crafts", "Health & Medical", "Home & Garden", "Home Appliances", "Industrial Machinery", "Jewelry, Eyewear & Watches", "Lights & Lighting", "Luggage, Bags & Cases", "Material Handling", "Packaging & Printing", "Parents, Kids & Toys", "Personal Care & Home Care", "Pet Supplies", "Power Transmission", "Raw Materials", "Renewable Energy", "Safety & Security", "School & Office Supplies", "Service", "Shoes & Accessories", "Sports & Entertainment", "Sportswear & Outdoor Apparel", "Testing Instrument & Equipment", "Tools & Hardware", "Vehicle Parts & Accessories", "Vehicles & Transportation", "Agriculture, Food & Beverage > Abalone", "Agriculture, Food & Beverage > Absinthe", "Agriculture, Food & Beverage > Baking Powder", "Agriculture, Food & Beverage > Duck", "Agriculture, Food & Beverage > Goose", "Agriculture, Food & Beverage > Hams", "Agriculture, Food & Beverage > Margarine", "Agriculture, Food & Beverage > Natural Plants", "Agriculture, Food & Beverage > Palm Sugar", "Agriculture, Food & Beverage > Rum", "Agriculture, Food & Beverage > Sandwiches", "Agriculture, Food & Beverage > Sauce", "Agriculture, Food & Beverage > Walnuts", "Apparel & Accessories > Belly dance Dress", "Apparel & Accessories > Brand Label", "Apparel & Accessories > Camouflage", "Apparel & Accessories > Church Hats", "Apparel & Accessories > Churidar", "Apparel & Accessories > Cloak", "Apparel & Accessories > Cord Lock", "Apparel & Accessories > Gym Fitness Sets", "Apparel & Accessories > Rhinestones", "Apparel & Accessories > Sports Jersey", "Apparel & Accessories > Top Hat", "Automotive Supplies & Tools > Auto Electronics", "Automotive Supplies & Tools > Car Alarms", "Automotive Supplies & Tools > Car Amplifiers", "Automotive Supplies & Tools > Car Interior Accessories", "Automotive Supplies & Tools > Car Rotisserie", "Automotive Supplies & Tools > Parking System", "Automotive Supplies & Tools > Ramps", "Automotive Supplies & Tools > Roof Rack", "Automotive Supplies & Tools > Throttle Controller", "Automotive Supplies & Tools > Tire Balancer", "Automotive Supplies & Tools > Wheel Cleaner", "Automotive Supplies & Tools > Window Breaker", "Automotive Supplies & Tools > Wiper Blades", "Beauty > Blackhead Remover", "Beauty > Body Shimmer", "Beauty > Cleaning Gel", "Beauty > Cosmetic", "Beauty > Cosmetic Set", "Beauty > Eyebrow Brush", "Beauty > Makeup Sets", "Beauty > Manicure Set", "Beauty > Nail Equipments", "Beauty > Nail Stamper", "Beauty > Nail Supplies", "Beauty > Tattoo Accessories", "Beauty > Tattoo Guns", "Commercial Equipment & Machinery > Cookie Machine", "Commercial Equipment & Machinery > Cooking Machine", "Commercial Equipment & Machinery > Fog Machine", "Commercial Equipment & Machinery > Food Trailer", "Commercial Equipment & Machinery > Gas Station", "Commercial Equipment & Machinery > Glass Engraving Machine", "Commercial Equipment & Machinery > Hotel Supplies", "Commercial Equipment & Machinery > Inflatable Tube", "Commercial Equipment & Machinery > Juice Dispenser", "Commercial Equipment & Machinery > Sheeps", "Commercial Equipment & Machinery > Shopping Baskets", "Commercial Equipment & Machinery > Smoke Extractor", "Construction & Building Machinery > Auger", "Construction & Building Machinery > Cement Making Machinery", "Construction & Building Machinery > Concrete Machine", "Construction & Building Machinery > Excavator Attachment", "Construction & Building Machinery > Garbage Truck", "Construction & Building Machinery > Gold Separator", "Construction & Building Machinery > Lifting Crane", "Construction & Building Machinery > Mining Machinery", "Construction & Building Machinery > Oxygen Generator", "Construction & Building Machinery > Stone Machinery", "Construction & Building Machinery > Torque Converter", "Construction & Building Machinery > Truck Cranes", "Construction & Real Estate > Bamboo Flooring", "Construction & Real Estate > Cabins", "Construction & Real Estate > Cement", "Construction & Real Estate > Forest", "Construction & Real Estate > Garage Door Opener", "Construction & Real Estate > Glass Block", "Construction & Real Estate > HVAC Systems", "Construction & Real Estate > Hotels", "Construction & Real Estate > Mosaics", "Construction & Real Estate > Plasterboards", "Construction & Real Estate > Roof Panel", "Construction & Real Estate > Shower Doors", "Construction & Real Estate > Wall Cabinet", "Construction & Real Estate > Wallpaper", "Consumer Electronics > Bass Amplifier", "Consumer Electronics > Bluetooth Receiver", "Consumer Electronics > Broadcasting Equipment", "Consumer Electronics > Camera Backpack", "Consumer Electronics > Camera Flash Lights", "Consumer Electronics > Electronic accessories", "Consumer Electronics > Home Theater Systems", "Consumer Electronics > Light Stand", "Consumer Electronics > Mounts", "Consumer Electronics > Phone Charm", "Consumer Electronics > Software", "Consumer Electronics > Vga Cable", "Consumer Electronics > Video Cameras", "Consumer Electronics > Web Camera", "Electrical Equipment & Supplies > Alligator Clips", "Electrical Equipment & Supplies > Cable Clips", "Electrical Equipment & Supplies > Dimmer Switch", "Electrical Equipment & Supplies > Enclosure", "Electrical Equipment & Supplies > Generator Controller", "Electrical Equipment & Supplies > Insulation Resistance Tester", "Electrical Equipment & Supplies > Led Connectors", "Electrical Equipment & Supplies > Power Box", "Electrical Equipment & Supplies > Rocker Switches", "Electrical Equipment & Supplies > Timer Switch", "Electrical Equipment & Supplies > Timers", "Electrical Equipment & Supplies > Voltage Tester", "Electronic Components > Antenna", "Electronic Components > Bluetooth Modules", "Electronic Components > Educational Kits", "Electronic Components > Electronic Modules", "Electronic Components > Gps Antenna", "Electronic Components > LEDs", "Electronic Components > Onu", "Electronic Components > Power Supplies", "Electronic Components > Switches", "Electronic Components > Terminal Blocks", "Electronic Components > Thermoelectric Cooler", "Fabrication Services > Casting Services", "Fabrication Services > Concrete Molds", "Fabrication Services > Forging Services", "Fabrication Services > Machining Services", "Fabrication Services > Sheet Metal Fabrication", "Furniture > Baby Cribs", "Furniture > Baby Fence", "Furniture > Baby Swing", "Furniture > Bar Tables", "Furniture > Book Shelf", "Furniture > Cabinet Handle", "Furniture > Egg Chair", "Furniture > Garden Furniture", "Furniture > Massage Table", "Furniture > Tea Table", "Furniture > Wine Racks", "Gifts & Crafts > Coin", "Gifts & Crafts > Fireworks", "Gifts & Crafts > Gift Sets", "Gifts & Crafts > Key Chain", "Gifts & Crafts > Natural stone", "Gifts & Crafts > Paper Lanterns", "Gifts & Crafts > Pendulum", "Gifts & Crafts > Posters", "Gifts & Crafts > Resin Crafts", "Gifts & Crafts > Shell", "Health & Medical > Ambulance Stretcher", "Health & Medical > Butt Plug", "Health & Medical > Ecg Machine", "Health & Medical > Hemodialysis Machine", "Health & Medical > Hemp Seeds", "Health & Medical > Massage Cushion", "Health & Medical > Massage Products", "Health & Medical > Oxygen Concentrator", "Health & Medical > Sm Products", "Health & Medical > Uv Sterilizer", "Health & Medical > Veterinary Medicine", "Health & Medical > Wheelchair", "Home & Garden > Bagel Slicer", "Home & Garden > Bathroom Accessories", "Home & Garden > Bottle Rack", "Home & Garden > Charging Lighter", "Home & Garden > Fence Posts", "Home & Garden > Fodder Trays", "Home & Garden > Garden Windmill", "Home & Garden > Pastry Cutter", "Home & Garden > Room Divider", "Home & Garden > Rotisserie Spit", "Home & Garden > Santa Claus", "Home & Garden > Stamp Album", "Home & Garden > Taper Candles", "Home & Garden > Witch Hat", "Home Appliances > Air Conditioner", "Home Appliances > Crepe Maker", "Home Appliances > Fan Cooler", "Home Appliances > Gas Range", "Home Appliances > Ice Cream Makers", "Home Appliances > Kitchen Appliances", "Home Appliances > Mist Maker", "Home Appliances > Solar Heater", "Home Appliances > Steam Mop", "Home Appliances > Table Fans", "Home Appliances > Tea Maker", "Home Appliances > Vacuum Cleaner Motor", "Home Appliances > Wine Refrigerators", "Industrial Machinery > Agricultural Trailer", "Industrial Machinery > Boom Sprayer", "Industrial Machinery > Crimping Machine", "Industrial Machinery > Crystallizers", "Industrial Machinery > Die Casting Machine", "Industrial Machinery > Electroplating Machinery", "Industrial Machinery > Engine Parts", "Industrial Machinery > English Wheels", "Industrial Machinery > Gasoline Engine", "Industrial Machinery > Honing Machines", "Industrial Machinery > Lathe Spindle", "Industrial Machinery > Socks Making Machine", "Industrial Machinery > Trimming Machine", "Industrial Machinery > Wood Shaving Machines", "Jewelry, Eyewear & Watches > Bracelet Box", "Jewelry, Eyewear & Watches > Clay Beads", "Jewelry, Eyewear & Watches > Contact Lenses", "Jewelry, Eyewear & Watches > Crystal Beads", "Jewelry, Eyewear & Watches > Headpiece", "Jewelry, Eyewear & Watches > Jade", "Jewelry, Eyewear & Watches > Nipple Ring", "Jewelry, Eyewear & Watches > Opal", "Jewelry, Eyewear & Watches > Spacer Beads", "Jewelry, Eyewear & Watches > Stainless Steel", "Lights & Lighting > Disco Light", "Lights & Lighting > Floor Light", "Lights & Lighting > Kerosene Lamp", "Lights & Lighting > Lamp Base", "Lights & Lighting > Led Light", "Lights & Lighting > Light controller", "Lights & Lighting > Music Lights", "Lights & Lighting > Night Lights", "Lights & Lighting > Outdoor Lighting", "Lights & Lighting > Pool Lights", "Lights & Lighting > Smart Bulbs", "Lights & Lighting > Sports Lighting", "Lights & Lighting > Working Light", "Luggage, Bags & Cases > Baby Bag", "Luggage, Bags & Cases > Beer Cooler", "Luggage, Bags & Cases > Cosmetic Bag", "Luggage, Bags & Cases > Kid's Luggage", "Luggage, Bags & Cases > Kids' Shoulder Bags", "Luggage, Bags & Cases > Medical Bags", "Luggage, Bags & Cases > Mommy Bags", "Luggage, Bags & Cases > Passport Wallet", "Luggage, Bags & Cases > Shoulder Bag", "Luggage, Bags & Cases > Sling Bag", "Luggage, Bags & Cases > Suitcase Set", "Material Handling > Conveyors", "Material Handling > Dollies", "Material Handling > Forklifts", "Material Handling > Hoists", "Material Handling > Manipulator", "Material Handling > Roller", "Material Handling > Shelves", "Material Handling > Trolley Cart", "Material Handling > Wheelbarrows", "Material Handling > Winches", "Packaging & Printing > Barrel", "Packaging & Printing > Beer Kegs", "Packaging & Printing > Egg Tray", "Packaging & Printing > Foil Paper", "Packaging & Printing > Jar", "Packaging & Printing > Oxygen Cylinder", "Packaging & Printing > Plastic Cover", "Packaging & Printing > Sublimation Ink", "Packaging & Printing > Wedding Favors", "Parents, Kids & Toys > Animal", "Parents, Kids & Toys > Aspirator", "Parents, Kids & Toys > Baby Souvenirs", "Parents, Kids & Toys > Baby Sweatshirt", "Parents, Kids & Toys > Beach Ball", "Parents, Kids & Toys > Boomerangs", "Parents, Kids & Toys > Bulls", "Parents, Kids & Toys > Corner Protector", "Parents, Kids & Toys > Doll Shoes", "Parents, Kids & Toys > Dollhouse Accessories", "Parents, Kids & Toys > Miscellaneous", "Parents, Kids & Toys > Swimming Pool", "Parents, Kids & Toys > Trading Cards", "Personal Care & Home Care > Curling Cream", "Personal Care & Home Care > Detergent", "Personal Care & Home Care > Dry Shampoo", "Personal Care & Home Care > Hair Perfume", "Personal Care & Home Care > Hair Sprays", "Personal Care & Home Care > Hair Styling Powder", "Personal Care & Home Care > Hand Cream", "Personal Care & Home Care > Laundry Soap", "Personal Care & Home Care > Men's Skin Care Set", "Personal Care & Home Care > Shaving Cream", "Personal Care & Home Care > Steam Cap", "Personal Care & Home Care > Washing Powder", "Personal Care & Home Care > Wood Polish", "Pet Supplies > Aquariums", "Pet Supplies > Cat Carrier", "Pet Supplies > Cat Toy", "Pet Supplies > Dog Car Seat", "Pet Supplies > Dog Food", "Pet Supplies > Dog House", "Pet Supplies > Dog Kennel", "Pet Supplies > Dog Toy", "Pet Supplies > Fish Food", "Pet Supplies > Pet Diaper", "Pet Supplies > Pet Food", "Pet Supplies > Pet Toys", "Power Transmission > Bearing", "Power Transmission > Cages", "Power Transmission > Fan Motor", "Power Transmission > Gearboxes", "Power Transmission > Housings", "Power Transmission > Hydraulic Fittings", "Power Transmission > Hydraulic Motors", "Power Transmission > Joint", "Power Transmission > Motor", "Power Transmission > Stepper Motors", "Power Transmission > Vibration Motors", "Raw Materials > 100% Linen Fabric", "Raw Materials > Camphor", "Raw Materials > Fabric", "Raw Materials > Gasoline", "Raw Materials > Hose", "Raw Materials > Metal Scrap", "Raw Materials > Nickel", "Raw Materials > PET", "Raw Materials > Polyester Fiber", "Raw Materials > Potassium Nitrate", "Raw Materials > Propylene Glycol", "Raw Materials > Sodium Hydroxide", "Raw Materials > Wire Rope", "Raw Materials > Wood Chips", "Renewable Energy > Energy Storage Battery", "Renewable Energy > Hydro Generator", "Renewable Energy > Hydrogen Fuel Cell", "Renewable Energy > Solar Cells", "Renewable Energy > Solar Generator", "Renewable Energy > Solar Kits", "Renewable Energy > Solar Light", "Renewable Energy > Solar Panels", "Renewable Energy > Solar Pump", "Renewable Energy > Solar Tracker", "Renewable Energy > Wind Power Generation System", "Renewable Energy > Wind Turbine", "Safety & Security > Barrier Gate", "Safety & Security > Boots", "Safety & Security > Emergency Kits", "Safety & Security > Face Shields", "Safety & Security > Fire Hose", "Safety & Security > Locksmith Tools", "Safety & Security > Military Supplies", "Safety & Security > Road Sign", "Safety & Security > Self Defense Supplies", "Safety & Security > Spy Camera", "Safety & Security > Surveillance Systems", "Safety & Security > Video Intercom", "School & Office Supplies > Art Supplies", "School & Office Supplies > Binder Clips", "School & Office Supplies > Calligraphy Brushes", "School & Office Supplies > Cutting Plotter", "School & Office Supplies > Fabric Paint", "School & Office Supplies > Glue Sticks", "School & Office Supplies > Money Envelope", "School & Office Supplies > Oil Pastel", "School & Office Supplies > Paint Palette", "School & Office Supplies > Paper Punch", "School & Office Supplies > Shredder", "School & Office Supplies > Tape Dispensers", "School & Office Supplies > Water Color", "Service > 3D Game Art", "Service > AI Chatbot", "Service > Book Design", "Service > Brand Style Design", "Service > Fashion Design", "Service > Flyer Design", "Service > Household items", "Service > Other Goods", "Service > Other Regions", "Service > PC Games", "Service > Quality Control", "Service > Supplier Search", "Service > Wix", "Shoes & Accessories > Athletic Shoes", "Shoes & Accessories > Bedroom Slippers", "Shoes & Accessories > Cowboy Boots", "Shoes & Accessories > Fur Slides", "Shoes & Accessories > Ladies Loafers", "Shoes & Accessories > Shoe Accessories", "Shoes & Accessories > Shoe Care Kits", "Shoes & Accessories > Shoelaces", "Shoes & Accessories > Soles", "Shoes & Accessories > Sport Sandals", "Shoes & Accessories > Waterproof Boots", "Sports & Entertainment > Climbing Rope", "Sports & Entertainment > Crossbow", "Sports & Entertainment > Fighting", "Sports & Entertainment > Fishing Gear", "Sports & Entertainment > Flying Car", "Sports & Entertainment > Horseshoes", "Sports & Entertainment > Kayak", "Sports & Entertainment > Novelties", "Sports & Entertainment > Paddle Boat", "Sports & Entertainment > Pom Poms", "Sports & Entertainment > Rescue Boat", "Sports & Entertainment > Scooter Accessories", "Sports & Entertainment > Speed Skates", "Sports & Entertainment > Surfboard Fins", "Sportswear & Outdoor Apparel > Arm Sleeve", "Sportswear & Outdoor Apparel > Cricket Shoes", "Sportswear & Outdoor Apparel > Cycling Shoes", "Sportswear & Outdoor Apparel > Diving Bags", "Sportswear & Outdoor Apparel > Football Boots", "Sportswear & Outdoor Apparel > Golf Shoes", "Sportswear & Outdoor Apparel > Hockey Bag", "Sportswear & Outdoor Apparel > Jockstrap", "Sportswear & Outdoor Apparel > Leg Massager", "Sportswear & Outdoor Apparel > Muay Thai Shorts", "Sportswear & Outdoor Apparel > Souvenirs", "Sportswear & Outdoor Apparel > Spike Shoes", "Sportswear & Outdoor Apparel > Volleyball Shoes", "Testing Instrument & Equipment > Flasks", "Testing Instrument & Equipment > Funnels", "Testing Instrument & Equipment > Gas Analyzers", "Testing Instrument & Equipment > Gas Regulator", "Testing Instrument & Equipment > Lab Equipment", "Testing Instrument & Equipment > Optics Instruments", "Testing Instrument & Equipment > Pocket Scale", "Testing Instrument & Equipment > Test Tubes", "Testing Instrument & Equipment > Thermal Camera", "Testing Instrument & Equipment > Water Test Kit", "Tools & Hardware > Ammo Box", "Tools & Hardware > Drill Set", "Tools & Hardware > Garden Forks", "Tools & Hardware > Hand Tools", "Tools & Hardware > Pickaxe", "Tools & Hardware > Rake", "Tools & Hardware > Refrigeration Tool", "Tools & Hardware > Sand Pump", "Tools & Hardware > Shelf Bracket", "Tools & Hardware > Studs", "Tools & Hardware > Swivels", "Tools & Hardware > Thimbles", "Tools & Hardware > Valve Seal", "Tools & Hardware > Welding Accessories", "Vehicle Parts & Accessories > Atv Accessories", "Vehicle Parts & Accessories > Auto Parts", "Vehicle Parts & Accessories > Boat Accessories", "Vehicle Parts & Accessories > Bus Accessories", "Vehicle Parts & Accessories > Bus Lights", "Vehicle Parts & Accessories > Lighting Accessories", "Vehicle Parts & Accessories > Motor Boat", "Vehicle Parts & Accessories > Radiator Tank", "Vehicle Parts & Accessories > Scooter Engines", "Vehicle Parts & Accessories > Tuning Lightings", "Vehicles & Transportation > ATVs", "Vehicles & Transportation > Boat Trailers", "Vehicles & Transportation > Car Trailers", "Vehicles & Transportation > Motorcycle", "Vehicles & Transportation > Pit Bike", "Vehicles & Transportation > Racing Motorcycles", "Vehicles & Transportation > Sport Car", "Vehicles & Transportation > Trailers", "Vehicles & Transportation > UTVs", "Vehicles & Transportation > Used Motorcycles" ], "type": "string", "description": "Pick an industry category. In Products it filters your keyword search to that category; in Category mode it browses the whole category. Leave blank for a plain keyword search." }, "maxResults": { "title": "Max results (10000 = unlimited)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum unique results. Per keyword for Products/Suppliers search; total across the whole category in Category mode or when a category filter is set. Set 10000 for unlimited.", "default": 100 }, "marketplace": { "title": "Marketplace", "enum": [ "standard", "worldwide" ], "type": "string", "description": "Standard Alibaba.com, or Worldwide (Regional supplies). Products mode only.", "default": "standard" }, "shipToCountry": { "title": "Deliver to", "enum": [ "US", "CN", "DE", "GB", "FR", "IT", "ES", "NL", "BE", "SE", "PL", "CH", "AT", "IE", "DK", "NO", "FI", "PT", "GR", "CZ", "IN", "JP", "KR", "HK", "SG", "MY", "TH", "VN", "ID", "PH", "AE", "SA", "TR", "IL", "CA", "MX", "BR", "AU", "NZ", "ZA" ], "type": "string", "description": "Buyer destination. Prices, local-stock availability, and delivery estimates localize to this country.", "default": "US" }, "includeSupplierReport": { "title": "Include supplier verification report", "type": "boolean", "description": "Add the full SGS-style due-diligence report for the verified manufacturer behind each product: registered capital, year established, floor space, employees, production capacity, and quality management. Billed separately, only when a report exists. Products mode.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "sales_volume" ], "type": "string", "description": "Order results by best match or by total units sold.", "default": "relevance" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum unit price (in the Deliver-to currency)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum unit price." }, "maxMOQ": { "title": "Max MOQ", "minimum": 1, "type": "integer", "description": "Only suppliers whose minimum order quantity is at most this." }, "supplierCountries": { "title": "Supplier countries", "type": "array", "description": "Filter by supplier location. Enter ISO country codes, e.g. CN, IN, DE. Works on Standard and Worldwide.", "default": [], "items": { "type": "string" } }, "minReviewScore": { "title": "Min review score", "enum": [ "any", "4", "4.5", "5" ], "type": "string", "description": "Only include suppliers at or above this store rating.", "default": "any" }, "verifiedSupplier": { "title": "Verified Supplier only", "type": "boolean", "description": "Only Verified Suppliers (independently checked).", "default": false }, "verifiedManufacturer": { "title": "Verified Manufacturer only", "type": "boolean", "description": "Only Verified Manufacturers (actual factories).", "default": false }, "tradeAssurance": { "title": "Trade Assurance only", "type": "boolean", "description": "Only suppliers offering Trade Assurance order protection.", "default": false }, "verifiedProSupplier": { "title": "Verified Pro Supplier only", "type": "boolean", "description": "Only Verified Pro Suppliers (top verification tier).", "default": false }, "companyAuthTags": { "title": "Company certifications", "type": "array", "description": "e.g. ISO, BSCI, AEO, IATF 16949.", "default": [], "items": { "type": "string" } }, "productCertTags": { "title": "Product certifications", "type": "array", "description": "e.g. CE, ROHS, UL, UKCA.", "default": [], "items": { "type": "string" } }, "maxDeliveryDays": { "title": "Max delivery days", "minimum": 1, "type": "integer", "description": "Only products that can ship within this many days." }, "localStock": { "title": "Local stock only", "type": "boolean", "description": "Only products held in local stock in the Deliver-to country.", "default": false }, "paidSamples": { "title": "Samples available", "type": "boolean", "description": "Only products that offer purchasable samples.", "default": false }, "guaranteed": { "title": "Guaranteed only", "type": "boolean", "description": "Only listings covered by Alibaba Guaranteed.", "default": false }, "includeReviews": { "title": "Include store reviews", "type": "boolean", "description": "Add the supplier's store reviews to each result: buyer country, rating, review text, photos, and the supplier's reply. Billed separately.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per result", "minimum": 0, "type": "integer", "description": "0 = all.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }