Global Sources APInbmarketunion.manufacturer.globalsources.com ↗
Access Global Sources manufacturer profiles via 5 endpoints: company overview, contact info, product categories, trade show history, and buyer reviews.
What is the Global Sources API?
This API exposes 5 endpoints covering Global Sources manufacturer and supplier profiles hosted under nbmarketunion.manufacturer.globalsources.com. The get_company_overview endpoint returns fields including business type, membership duration, main markets, and supplier response rate. The remaining endpoints cover verified contact details, product category hierarchies, trade show participation records, and structured buyer reviews — all keyed by a numeric org_id.
curl -X GET 'https://api.parse.bot/scraper/8764d05f-8981-4574-87ec-7197abddfbfc/get_company_overview?org_id=2008857566700' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace nbmarketunion-manufacturer-globalsources-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
Global Sources Company Profile API — typed SDK usage example.
Get your API key from: https://parse.bot/settings
"""
from parse_apis.global_sources_company_profile_api import GlobalSources
gs = GlobalSources(api_key="YOUR_API_KEY")
# Fetch a company overview by org_id
company = gs.companies.get(org_id="2008857566700")
print(company.company_name, company.year_established)
print("Verified supplier:", company.verified_supplier)
print("Main markets:", company.main_markets)
# Get contact information
contact = company.contact()
print(contact.contact_person, contact.city, contact.country)
# List product categories
for cat in company.categories():
print(cat.group_name, cat.id)
# List trade show appearances
for show in company.trade_shows():
print(show.name, show.show_date, show.city)
# Browse buyer reviews
for review in company.reviews():
print(review.author.name, review.review_rating.rating_value, review.review_body)
Retrieves a supplier's company overview including name, logo, business types, verification status, response metrics, main markets, products, and sales figures. Combines data from the header-snapshot and company-snapshot APIs. A single round-trip per source; no pagination.
| Param | Type | Description |
|---|---|---|
| org_idrequired | string | Organization ID on Global Sources (numeric string, e.g. '2008857566700'). |
{
"type": "object",
"fields": {
"logo_url": "URL of the company logo",
"company_name": "string",
"main_markets": "string of comma-separated market regions",
"member_since": "integer membership tier/duration",
"main_products": "array of product keyword strings",
"response_rate": "string",
"response_time": "integer rating enum",
"business_types": "array of business type strings",
"overview_images": "array of image objects with name, url, and pageTitle",
"year_established": "string",
"verified_supplier": "boolean",
"total_annual_sales": "string describing sales range",
"verified_manufacturer": "boolean"
},
"sample": {
"data": {
"logo_url": "https://s.globalsources.com/IMAGES/SPL/LOGO/700/L8857566700.jpg?ver=5674718040",
"company_name": "Market Union Co. Ltd",
"main_markets": "Asia, Australasia, North America, Western Europe",
"member_since": 2,
"main_products": [
"Kitchen",
"Cleaning",
"Home Decoration"
],
"response_rate": "High",
"response_time": 2,
"business_types": [
"Trading Company",
"Wholesaler"
],
"overview_images": [
{
"url": "https://s.globalsources.com/IMAGES/SPL/GWS/684/G5315832684.jpg",
"name": "Serving the World",
"type": 0,
"pageTitle": "TRDSVS",
"uploadDate": null,
"coverImageUrl": ""
}
],
"year_established": "2003",
"verified_supplier": true,
"total_annual_sales": "US$500,000,000 to 999,999,999",
"verified_manufacturer": false
},
"status": "success"
}
}About the Global Sources API
Company Overview and Contact Data
The get_company_overview endpoint accepts a numeric org_id string and returns fields such as company_name, logo_url, year_established, member_since (a membership tier/duration integer), main_markets (a comma-separated string of regions), business_types (an array of classification strings), response_rate, and response_time. It also returns overview_images — an array of objects each carrying a name, url, and pageTitle — which can be used to display a supplier's profile gallery.
The get_contact_information endpoint returns address components (address, city, province, zip_code), an ISO country code, hotline, email, website, and a contact_person name. All fields are nullable; an unrecognized org_id returns null across all contact fields rather than an error.
Product Categories and Trade Show History
get_product_categories returns an array of category objects keyed by id, with groupName, groupLevel, imageUrl, and productImageUrl. This lets you understand a supplier's product scope without fetching individual listings. An unrecognized org_id returns an empty array.
get_trade_shows returns the supplier's trade show participation history as an array. Each record includes tsName, tsCity, tsLocation, boothNum, showDate (a formatted date range string), countryCode, and a numeric tradeshowId. This data is useful for assessing how active a supplier is at physical sourcing events.
Buyer Reviews
get_buyer_reviews returns structured review objects. Each entry carries an author object (with @type and name), a reviewBody string, and a reviewRating object (with @type and ratingValue). The @type field is always 'Review'. If a supplier has no buyer reviews on file, the endpoint returns an empty array.
The Global Sources API is a managed, monitored endpoint for nbmarketunion.manufacturer.globalsources.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nbmarketunion.manufacturer.globalsources.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official nbmarketunion.manufacturer.globalsources.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a supplier vetting tool that combines
get_company_overviewresponse rate andget_buyer_reviewsratings to score manufacturer reliability. - Enrich a sourcing CRM by pulling
get_contact_informationfields — email, hotline, and contact person — for shortlisted Global Sources suppliers. - Map trade show attendance patterns using
get_trade_showsdata to identify which suppliers are active in specific countries or date ranges. - Categorize and filter a large supplier list by product scope using
get_product_categoriesgroupName and groupLevel fields. - Display supplier profile galleries in a procurement tool using the
overview_imagesarray returned byget_company_overview. - Identify long-standing manufacturers by comparing
year_establishedandmember_sincevalues across multipleorg_idlookups. - Cross-reference
main_marketsand ISOcountrycodes from contact info to find suppliers already active in a target export region.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Global Sources offer an official developer API?+
What does `get_trade_shows` return, and does it include upcoming events?+
get_trade_shows returns historical participation records including trade show name, city, venue, booth number, and a formatted date range string. The data reflects past participation as recorded on the supplier's profile; there is no field distinguishing upcoming versus completed events, and future-scheduled shows may not be included.What happens when an `org_id` is not recognized by the API?+
get_contact_information, get_product_categories, and get_trade_shows return null fields or empty arrays respectively for unknown org_id values. get_company_overview may return an upstream server error for invalid IDs, so it is worth validating org_id values before calling that endpoint.Does the API return individual product listings for a supplier?+
Are supplier certification or audit records available?+
get_company_overview endpoint includes a verification status signal but does not return detailed certification records, third-party audit reports, or quality management credentials. You can fork this API on Parse and revise it to add an endpoint targeting certification data from the supplier profile.