volza.com APIvolza.com ↗
Search global import/export trade data from Volza.com. Retrieve HS codes with shipment counts, buyers, suppliers, and company profiles via 4 endpoints.
curl -X GET 'https://api.parse.bot/scraper/266e4c1c-8c7f-4e92-aaa0-1b75f466f191/search_product?query=garments' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword and get related HS (Harmonized System) codes with trade shipment counts and descriptions. Returns a list of HS codes sorted by shipment volume. Some keywords may return no results if they don't match indexed product descriptions; try variations (e.g. 'telephones' instead of 'telephone').
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Product keyword to search (e.g. 'spices', 'electronics', 'telephones'). Must be non-empty. |
{
"type": "object",
"fields": {
"query": "string - the search query submitted",
"hs_codes": "array of objects with hsn_code (string), total_shipments (string), and description (string)",
"is_hs_code": "boolean - whether the query was interpreted as an HS code rather than a product name"
},
"sample": {
"data": {
"query": "spices",
"hs_codes": [
{
"hsn_code": "0910",
"description": "ginger, saffron, turmeric (curcuma), thyme, bay leaves, curry and other spices - ginger:",
"total_shipments": "49056"
},
{
"hsn_code": "2103",
"description": "sauces and preparations therefor, mixed condiments and mixed seasonings; mustard flour and meal and prepared mustard",
"total_shipments": "22425"
}
],
"is_hs_code": false
},
"status": "success"
}
}About the volza.com API
The Volza API exposes global trade data across 4 endpoints, letting you look up HS/HSN codes by product keyword, retrieve buyer and supplier lists for specific product categories, and pull company profile details. The search_product endpoint returns an array of HS codes ranked by total shipment volume, giving you an immediate picture of how a given product moves through international trade.
Product and HS Code Search
The search_product endpoint accepts a query string — a product keyword like 'spices', 'electronics', or 'telephones' — and returns a hs_codes array. Each element includes hsn_code, total_shipments, and description. Results are sorted by shipment volume, so the most-traded HS codes for a given product appear first. The response also includes an is_hs_code boolean indicating whether the API interpreted the query as a literal HS code rather than a product name. If a keyword returns no results, try broader or alternate product terms.
Buyers and Suppliers by HS Code
get_product_buyers and get_product_suppliers both take two required parameters: hsn (the HS/HSN code, e.g. '0910') and product (a product slug, e.g. 'spices'). Each returns a companies array. Use search_product first to identify the correct hsn and product slug, then pass those values into either endpoint to enumerate the buyers or suppliers trading under that product category.
Company Profiles
get_company_profile takes a slug parameter — for example, 'mtr-foods-private-limited-2588043' — and returns the company's name, url, and total_shipments count. Company slugs appear in the companies arrays returned by the buyer and supplier endpoints, making a natural traversal: search a product, get buyers or suppliers, then fetch profiles for specific companies of interest.
- Build a supplier discovery tool that maps HS codes to manufacturers using
get_product_suppliers. - Identify the largest buyers in a product category by querying
get_product_buyersfor a specific HSN code. - Enrich a B2B prospecting database with shipment volume data from
get_company_profile. - Classify products into HS codes programmatically by running keywords through
search_productand extractinghsn_codevalues. - Compare shipment volumes across competing HS codes for a product family using the
total_shipmentsfield. - Monitor which companies are active importers or exporters for a given commodity by iterating over the
companiesarray from buyer/supplier endpoints.
| 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 | 250 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 Volza.com have an official developer API?+
What does `search_product` return when I pass an HS code as the query instead of a product name?+
hs_codes array, but the is_hs_code boolean is set to true, indicating the query was treated as a direct HS code lookup rather than a keyword search against product descriptions.Does the API return detailed shipment records — dates, quantities, ports, or trade partners — for individual transactions?+
Can I filter buyers or suppliers by country or region?+
get_product_buyers and get_product_suppliers endpoints do not currently expose country filter parameters — they accept only hsn and product. You can fork this API on Parse and revise it to add country-scoped endpoints.