# GlobalSources Supplier Scraper (`maximedupre/globalsources-supplier-scraper`) Actor Find Global Sources suppliers and manufacturers by product keyword. Save company details, profile links, verification data, and sample products to a dataset. - **URL**: https://apify.com/maximedupre/globalsources-supplier-scraper.md - **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community) - **Categories:** E-commerce, Lead generation, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.15 / 1,000 supplier profiles This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### 🔎 Find Global Sources suppliers by product GlobalSources Supplier Scraper helps sourcing teams and online sellers find suppliers and manufacturers by product keyword. It saves company names, locations, profile links, verification details, and sample products in a dataset for supplier research. - Build a supplier list with the **[GlobalSources Supplier Scraper](https://apify.com/maximedupre/globalsources-supplier-scraper/examples/globalsources-supplier-scraper)**. - Find matching companies with **[Global Sources Supplier Search](https://apify.com/maximedupre/globalsources-supplier-scraper/examples/global-sources-supplier-search)**. - Look for factories with **[Global Sources Manufacturers](https://apify.com/maximedupre/globalsources-supplier-scraper/examples/global-sources-manufacturers)**. - Find exporters with the **[Global Sources Exporter](https://apify.com/maximedupre/globalsources-supplier-scraper/examples/global-sources-exporter)** task. - Export company and product details with **[Global Sources Scraper](https://apify.com/maximedupre/globalsources-supplier-scraper/examples/global-sources-scraper)**. #### 📦 What data does it return? Each row is one supplier found for a product keyword. Data may include: - Company name, location, supplier ID, and profile URL - Global Sources verification level and platform tenure - Verified manufacturer, verified supplier, and assessed company status - Business types, company specialty, and certifications - Sample products with prices, minimum order quantities, lead times, and FOB ports - VR showroom details, the first matched keyword, and extraction time Global Sources labels and certifications are source data. They do not guarantee that a supplier is right for your needs. #### ▶️ How to run the Actor 1. Open the Actor in Apify Console. 2. Add one or more product keywords. 3. Add business type or location filters if needed. 4. Set a supplier limit, or clear it to get all available results until the source is exhausted. 5. Click **Start** and open the default dataset when the run ends. You do not need to provide Global Sources login details. You can also run the Actor with the Apify API or a schedule. #### 🧩 Input | Field | Type | What it does | |---|---|---| | `keywords` | string array | Searches for suppliers of one or more products. Every keyword uses the same filters. | | `businessTypes` | string array | Keeps suppliers with any chosen business type. Leave it empty to include every type. | | `supplierLocations` | string array | Keeps suppliers from chosen countries or regions. Use names shown by Global Sources. Leave it empty to include every location. | | `maxItems` | integer | Stops after this many unique suppliers. Leave it empty to return all available results until the source is exhausted. | The default input used in Hosted QA is: ```json { "keywords": [ "LED lights" ], "maxItems": 25 } ```` When the same supplier is found more than once, the first eligible match is saved. Later matches do not change that row. #### 📄 Output The Actor saves supplier rows to the default dataset. Optional fields appear only when Global Sources provides them. | Field | Type | What it does | |---|---|---| | `supplierId` | string | Stable supplier ID from Global Sources. | | `companyName` | string | Official company name. | | `location` | string | Country or region shown for the supplier. | | `profileUrl` | string | Direct Global Sources supplier profile link. | | `keyword` | string | Product keyword that first led to the saved supplier. | | `verificationLevel` | string | Verification level shown by Global Sources. | | `platformTenure` | string | Time the supplier has been listed on Global Sources. | | `isVerifiedManufacturer` | boolean | Whether Global Sources marks it as a verified manufacturer. | | `isVerifiedSupplier` | boolean | Whether Global Sources marks it as a verified supplier. | | `isAssessedCompany` | boolean | Whether Global Sources marks it as assessed. | | `businessTypes` | string array | Business types shown for the supplier. | | `positioningSummary` | string | Short company focus or specialty text. | | `companyCertifications` | string array | Company certifications shown for the supplier. | | `productCertifications` | string array | Product certifications shown for its products. | | `representativeProducts` | object array | Sample products shown with the supplier. | | `representativeProducts.productId` | string | Stable Global Sources product ID. | | `representativeProducts.name` | string | Product name. | | `representativeProducts.price` | string | Price or range, with currency when shown. | | `representativeProducts.minimumOrderQuantity` | string | Smallest order and unit when shown. | | `representativeProducts.leadTime` | string | Stated time to prepare or ship the product. | | `representativeProducts.fobPort` | string | Named FOB shipping port. | | `hasVrShowroom` | boolean | Whether the supplier has a VR showroom. | | `vrShowroomUrl` | string | Direct VR showroom link. | | `extractedAt` | datetime string | Date and time the supplier row was saved. | ```json { "supplierId": "6003002400821", "companyName": "Shenzhen 3Ray Lighting Technology Co.Ltd", "location": "China", "profileUrl": "https://3raylighting.manufacturer.globalsources.com/homepage_6003002400821.htm", "keyword": "LED lights", "positioningSummary": "Shenzhen 3Ray Lighting Technology Co.LtdGlobal Sourceshttps://3raylighting.manufacturer.globalsources.com › ho...Global Sourceshttps://3raylighting.manufacturer.globalsources.com › ho...Shenzhen 3Ray Lighting Technology Co.Ltd - High-efficiency LED lighting solution provider with 12 years' experience - China outdoor led lights, ...", "extractedAt": "2026-07-25T21:02:30.699Z" } ``` Export the dataset as JSON, CSV, Excel, XML, or another format supported by Apify. #### 💳 Pricing This Actor uses pay-per-event pricing. You are charged for each unique supplier profile saved to the dataset. A run that saves no supplier profiles has no supplier-profile event charge. See the Actor page for your current price tier. #### 🔌 Integrations Use the dataset with the Apify API, webhooks, schedules, Zapier, Make, Google Sheets, or other Apify integrations. https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4 #### ❓ FAQ ##### Can I search more than one product? Yes. Add each product to `keywords`. The same filters apply to every keyword in that run. ##### Can I limit results by supplier type or place? Yes. Use `businessTypes` and `supplierLocations`. Leave either field empty to include all values for that filter. ##### What happens when two keywords find the same supplier? Only the first eligible match is saved. The row keeps the keyword that first led to it. ##### Does the Actor scrape every product on a supplier profile? No. It saves the sample products available in supplier discovery results. It does not crawl the supplier's full catalog. ##### Does a verification label prove that a supplier is trustworthy? No. The Actor reports labels shown by Global Sources. Review each supplier and certification before making a business choice. ##### Do I need a Global Sources account? No login details are needed in the Actor input. ### 📝 Changelog #### 0.0: Initial release ### 🆘 Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~globalsources-supplier-scraper/issues) and I'll fix or implement it in less than 24h 🫡 ### 🔗 Related Actors - [1688 Supplier Scraper](https://apify.com/maximedupre/1688-com-supplier-scraper) — Research factories, marketplace signals, and sample offers on 1688. - [GlobalSources Products Scraper](https://apify.com/devcake/globalsources-products-scraper) — Find Global Sources products with price, MOQ, and lead-time data. - [Alibaba Supplier Scraper](https://apify.com/devcake/alibaba-supplier-scraper) — Compare Alibaba supplier profiles and factory details. - [Made-in-China Scraper](https://apify.com/santamaria-automations/made-in-china-scraper) — Research manufacturers and company details on Made-in-China. - [IndiaMART Scraper](https://apify.com/parseforge/indiamart-scraper) — Find IndiaMART products, suppliers, prices, and contact details. **Made with ❤️ by Maxime Dupré** # Actor input Schema ## `keywords` (type: `array`): Enter one or more products to find suppliers for. Each keyword uses the same filters in this run. ## `businessTypes` (type: `array`): Only save suppliers with one of these business types. Leave this empty to include every business type. ## `supplierLocations` (type: `array`): Only save suppliers from these countries or regions. Enter names used by Global Sources, such as China or Hong Kong SAR. Leave this empty to include every location. ## `maxItems` (type: `integer`): Stop after saving this many unique suppliers. Leave this empty to save all available suppliers. ## Actor input object example ```json { "keywords": [ "LED lights", "solar panels" ], "businessTypes": [ "manufacturer", "exporter" ], "supplierLocations": [ "China", "Hong Kong SAR" ], "maxItems": 100 } ``` # Actor output Schema ## `dataset` (type: `string`): Open the saved supplier profiles in the default dataset. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "LED lights" ], "maxItems": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/globalsources-supplier-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["LED lights"], "maxItems": 25, } # Run the Actor and wait for it to finish run = client.actor("maximedupre/globalsources-supplier-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "LED lights" ], "maxItems": 25 }' | apify call maximedupre/globalsources-supplier-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/globalsources-supplier-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GlobalSources Supplier Scraper", "description": "Find Global Sources suppliers and manufacturers by product keyword. Save company details, profile links, verification data, and sample products to a dataset.", "version": "0.0", "x-build-id": "aTkiezcaUIs2T9mHP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~globalsources-supplier-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-globalsources-supplier-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/maximedupre~globalsources-supplier-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-globalsources-supplier-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/maximedupre~globalsources-supplier-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-globalsources-supplier-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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Product keywords", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Enter one or more products to find suppliers for. Each keyword uses the same filters in this run.", "items": { "type": "string", "minLength": 1 } }, "businessTypes": { "title": "Business types", "uniqueItems": true, "type": "array", "description": "Only save suppliers with one of these business types. Leave this empty to include every business type.", "items": { "type": "string", "enum": [ "manufacturer", "exporter", "trading-company", "wholesaler", "agent", "distributor", "importer", "retailer", "online-seller", "buying-office" ], "enumTitles": [ "Manufacturer", "Exporter", "Trading company", "Wholesaler", "Agent", "Distributor", "Importer", "Retailer", "Online seller", "Buying office" ] } }, "supplierLocations": { "title": "Supplier countries or regions", "uniqueItems": true, "type": "array", "description": "Only save suppliers from these countries or regions. Enter names used by Global Sources, such as China or Hong Kong SAR. Leave this empty to include every location.", "items": { "type": "string", "minLength": 1 } }, "maxItems": { "title": "Maximum suppliers", "minimum": 1, "type": "integer", "description": "Stop after saving this many unique suppliers. Leave this empty to save all available suppliers." } } }, "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 } } } } } } } } } } ```