# Zauba Trade Data Scraper (`parseforge/zauba-scraper`) Actor

Scrapes Indian import and export shipment records from Zauba by product keyword or direct URL. Returns HS code, date, port, country, quantity, and unit price for each row.

- **URL**: https://apify.com/parseforge/zauba-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Automation, Developer tools, Other
- **Stats:** 80 total users, 11 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $12.99 / 1,000 result items

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/actors/running/actors-in-store.md#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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Zauba Trade Data Scraper

**Scrape Indian import and export trade records from Zauba by product keyword or direct URL.** Every record includes the HS code, shipment date, port, foreign country, quantity, and unit price. No login required. Export to CSV, JSON, Excel, or XML.

Zauba publishes detailed Indian customs shipment records, but manually searching and copying data across thousands of pages is slow and error-prone. This scraper reads the public trade feeds directly, filtering by product keyword and trade direction, and returns each matching shipment in a consistent flat schema. It handles pagination and rate-limiting so you get clean data without writing any code.

| Who uses it | What they scrape Zauba for |
|---|---|
| Import/export businesses | Find active buyers or suppliers of a specific product in India. |
| Market analysts | Track trade volumes and price trends for a commodity over time. |
| Logistics and freight companies | Identify companies shipping high volumes on specific trade lanes. |
| Academic researchers | Gather primary shipment data for studies on Indian trade patterns. |

### What it does

This Actor collects Indian import or export trade records from Zauba by product keyword or direct URL and returns each shipment as a flat row.

- 🔍 **Product keyword search:** Enter a product name like 'laptop', 'cotton', or 'steel' and choose import or export.
- 🔗 **Direct URL input:** Paste any Zauba search results URL to scrape a pre-filtered list of shipments.
- 📊 **Structured output:** Each record returns HS code, product description, shipment date, port, foreign country, quantity, unit, and unit price INR.
- ⏱️ **Configurable volume:** Set a maximum number of records to collect, from a quick sample up to 1,000,000 rows for paid users.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Zauba data

**📦 Find suppliers of a raw material.**

A manufacturer searches for 'cotton' exports to see which Indian companies are shipping the material and at what prices.

**📈 Monitor competitor import volumes.**

A brand tracks imports of 'laptop' to estimate how many units a rival is bringing into India each month.

**🌏 Discover new trade partners.**

A freight forwarder scrapes exports of 'steel' to build a list of Indian shippers moving goods to a specific foreign country.

**💰 Analyze unit price trends.**

An analyst collects a year of 'rice' export records to chart how the per-unit INR price changes by season and destination.

### Why choose this scraper

|  | What you get |
|---|---|
| **No manual copying** | Extract thousands of shipment records automatically instead of clicking through pages. |
| **Consistent schema** | Every row has the same fields, ready for analysis in Excel or a database. |
| **Trade direction filter** | Separate import and export data to focus on the supply or demand side. |
| **Flexible input** | Start from a simple keyword or a precise URL you already filtered on the site. |

### How it compares

No other Store actor targets Zauba the same way, so the honest comparison is with the alternatives teams actually weigh.

| | Zauba Trade Data Scraper | Build it in-house | By hand |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When Zauba changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |

### Configure the run

Drive the Actor with a product keyword and trade type, or a direct Zauba URL, and set a maximum record count to control the size of your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "product": "laptop",
  "tradeType": "import",
  "maxItems": 10
}
```

A larger pull:

```json
{
  "product": "laptop",
  "tradeType": "import",
  "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.01734 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $1.73 |
| 1,000 results | $17.34 |
| 10,000 results | $173.40 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Zauba Trade Data Scraper](https://apify.com/parseforge/zauba-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Zauba through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/zauba-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that your product keyword matches terms used on Zauba. Try a broader term. Also, ensure you have selected the correct trade type. If using a direct URL, verify it is a valid Zauba search results page.

**The scraper stopped before reaching my max items limit.**

Zauba may not have as many records as you requested for that keyword. The Actor stops when it reaches the end of the available results. Try a more general keyword or a different trade type.

**I am getting an error or timeout.**

The website might be temporarily slow. Try reducing the max items count or running the Actor at a different time. If the problem persists, check the Apify platform status or contact support.

**Some fields are empty in my output.**

Not every shipment record on Zauba has all fields filled in. Missing data on the website will appear as empty values in your dataset. This is normal.

### FAQ

| Question | Answer |
|---|---|
| What is Zauba? | Zauba is a public platform that aggregates Indian import and export shipment data from customs manifests. It provides details like HS codes, quantities, and foreign trade partners. |
| Do I need a Zauba account or API key? | No. This scraper reads the publicly accessible pages on Zauba. You do not need to register, log in, or use an API key. |
| What data fields does the scraper return? | Each record includes the HS code, product description, shipment date, Indian port, foreign country, quantity, unit, and unit price in INR. The exact fields are shown in the sample output on the Actor's page. |
| Can I scrape both import and export data? | Yes. Use the trade type selector to choose 'Import' or 'Export'. The scraper builds the correct URL for the direction you need. |
| How many records can I scrape? | Free Apify users are limited to 100 records per run. Paid users can set a higher maximum, up to 1,000,000 records. |
| What if I already have a filtered Zauba URL? | Paste it into the 'Zauba URL' field. The Actor will scrape that exact results page and all its pagination, ignoring the product and trade type fields. |
| Is the data in English? | Yes. Zauba's interface and the scraped product descriptions are in English. The foreign country names and port names are also in English. |
| Can I schedule this scraper to run daily? | Yes. Once you have configured the input, you can set up an Apify schedule to run the Actor automatically at any interval. |
| What export formats are supported? | You can export your dataset in CSV, JSON, Excel, XML, or RSS feed format from the Apify platform. |
| Does this scraper handle Zauba's rate limiting? | Yes. The Actor is built to respect the website's response times and will manage the request rate to avoid being blocked. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Zauba Technologies & Data Services Private Limited. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `product` (type: `string`):

Product keyword to search for (e.g., 'laptop', 'cotton', 'steel'). Used to build the URL path.

## `tradeType` (type: `string`):

Whether to scrape import or export records.

## `startUrl` (type: `string`):

Direct URL to scrape (e.g., https://www.zauba.com/import-laptop/p-1-hs-code.html). If provided, 'Product' and 'Trade Type' are ignored.

## `maxItems` (type: `integer`):

Free users: Limited to 100. Paid users: Optional, max 1,000,000

## Actor input object example

```json
{
  "product": "laptop",
  "tradeType": "import",
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with all scraped items

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "product": "laptop",
    "tradeType": "import",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/zauba-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "product": "laptop",
    "tradeType": "import",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/zauba-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "product": "laptop",
  "tradeType": "import",
  "maxItems": 10
}' |
apify call parseforge/zauba-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/zauba-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/n6yX7UNd7I9K4VQcM/builds/PHPQv38brwEnLYy7U/openapi.json