Volza APIvolza.com ↗
Search Volza.com trade data via API. Get HS codes with shipment counts, drill into buyers, suppliers, and company profiles for any product category.
What is the Volza API?
The Volza API exposes global import/export trade intelligence across 4 endpoints. Starting with search_product, you can look up any product keyword and receive up to 19 matching HS/HSN codes, each with a shipment count and standardized description. From there, endpoints for buyers, suppliers, and company profiles let you trace trade flows from product category down to individual company.
curl -X GET 'https://api.parse.bot/scraper/266e4c1c-8c7f-4e92-aaa0-1b75f466f191/search_product?query=spices' \ -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 volza-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.
"""Walkthrough: Volza Trade Intelligence SDK — search trade HS codes by product keyword."""
from parse_apis.volza_trade_intelligence_api import Volza, NotFoundError
volza = Volza()
# Search for HS codes related to a product keyword
result = volza.productsearches.search(query="electronics")
print(result.query, result.is_hs_code)
# Access typed HS code objects with shipment counts
for hs_code in result.hs_codes[:5]:
print(hs_code.hsn_code, hs_code.total_shipments, hs_code.description[:60])
# Typed error handling: catch when an empty/invalid query is rejected
try:
empty_result = volza.productsearches.search(query="spices")
print(empty_result.query, len(empty_result.hs_codes), "HS codes found")
except NotFoundError as exc:
print(f"not found: {exc}")
print("exercised: productsearches.search / HSCode field access / error handling")
Search for products by keyword and get related HS (Harmonized System) codes with trade shipment counts and descriptions. Returns up to 19 HS codes sorted by shipment volume. Keywords match against indexed product descriptions; some terms may return no results while variations succeed (e.g. 'spices' returns results but 'spice' may not). The response also indicates whether the query was interpreted as an HS code itself.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Product keyword to search (e.g. 'spices', 'electronics', 'furniture'). 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 API
Product and HS Code Search
The search_product endpoint accepts a query string — a product keyword like spices, electronics, or furniture — and returns an array of hs_codes objects. Each object contains an hsn_code, a total_shipments count, and a plain-language description. Results are sorted by shipment volume and capped at 19 entries. The response also includes an is_hs_code boolean that tells you whether the API interpreted the query as a direct HS code lookup rather than a keyword search. Note that some keyword variations return no results while closely related terms may match; testing a few synonyms is worth doing when initial queries come back empty.
Buyers and Suppliers by Product
get_product_buyers and get_product_suppliers both accept two parameters: hsn (the HS code, e.g. 0910) and product (a product slug like spices). Both return a companies array representing the buyers or suppliers active in that product-code combination. These endpoints are the bridge between a trade category and the actual companies moving goods under that classification.
Company Profiles
get_company_profile takes a slug parameter — for example, mtr-foods-private-limited-2588043 — and returns the company's name, a url linking to its Volza profile, and a total_shipments figure. Company slugs are surfaced in the buyer and supplier results, so a typical workflow chains all four endpoints: search a product, identify an HS code, pull buyers or suppliers, then fetch profiles for companies of interest.
The Volza API is a managed, monitored endpoint for volza.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when volza.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 volza.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?+
- Identify which HS codes carry the highest shipment volumes for a product category before entering a new market
- Build a supplier shortlist for a given HS code using
get_product_suppliersto find active manufacturers - Enrich a B2B leads database with total shipment counts from
get_company_profile - Map competitive buyer landscapes for a specific HSN code using
get_product_buyers - Validate HS code classification by comparing keyword search results against known shipment volumes
- Screen trade partners by cross-referencing buyer and supplier company slugs with company profile data
| 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 Volza offer an official developer API?+
What exactly does `search_product` return, and are results filtered by country?+
hsn_code, total_shipments, and description, sorted by shipment volume. The endpoint does not currently accept a country filter — results reflect global shipment data across all trade lanes. You can fork this API on Parse and revise it to add country-scoped filtering if your use case requires it.Does the API return individual shipment records or transaction-level detail?+
How complete is the `companies` array returned by buyer and supplier endpoints?+
companies array is returned as-is from the data source for the given HSN and product slug combination. No documented cap or pagination parameter is exposed on these endpoints, so the count of results may vary by product category and HS code popularity. Niche codes with low shipment volumes may return short or empty arrays.