# Paraguay Customs Import/Export Records Scraper \[🏷️ ON SALE 🎉] (`scrapers_lat/paraguay-customs-scraper`) Actor
Extract shipment-level Paraguay customs import and export records from the official DNA open-data portal by year and month.
- **URL**: https://apify.com/scrapers\_lat/paraguay-customs-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 1,000 results
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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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
[](https://console.apify.com/actors/LuBCO08I9mds2jxXQ/input)
## Paraguay Customs Import/Export Records Scraper
> Extract shipment-level import and export records from Paraguay's National Customs Directorate (DNA) open-data portal, covering every month from 1997 to today
40+ fields per record
1997 to present coverage
JSON / CSV / Excel output formats
### What you get
Each record is a single customs operation line: one tariff item from an import or export dispatch, with its HS / NCM code, merchandise description, countries, quantities, weights, declared values and the full duty and tax breakdown. Use it to track trade flows by product, country and customs regime, build market-sizing datasets, monitor competitors' goods, or feed pricing and tariff models.
- **operation**: whether the line is an import (IMPORTACION) or export (EXPORTACION)
- **dispatchId**: the ciphered customs dispatch identifier the operation belongs to
- **itemNumber**: the item number within the dispatch
- **regimeCode**: the customs regime code (for example IC04, ZF2M)
- **regime**: the full customs regime description
- **customsOffice**: the customs office that processed the operation
- **officializationDate**: the date the dispatch was officialized
- **clearanceDate**: the date the operation was cleared or cancelled
- **year**: the calendar year of the operation
- **month**: the calendar month of the operation
- **transportMode**: the means of transport (for example AVION, CAMION, BUQUE)
- **channel**: the inspection channel assigned to the operation
- **usdGuaraniRate**: the US dollar to guarani exchange rate applied
- **hsCode**: the NCM / Mercosur tariff position
- **chapterDescription**: the HS chapter description
- **headingDescription**: the HS heading description
- **positionDescription**: the full tariff position description
- **merchandise**: the declared merchandise description
- **brand**: the declared item brand
- **tradeAgreement**: the trade agreement applied to the line
- **condition**: the goods condition (for example NUEVO, USADO)
- **countryOfOrigin**: the country where the goods originated
- **countryOfProvenanceDestination**: the country of provenance for imports or destination for exports
- **statisticalUnit**: the statistical unit of measure
- **statisticalQuantity**: the statistical quantity declared
- **netWeightKg**: the net weight in kilograms
- **grossWeightKg**: the gross weight in kilograms
- **fobUsd**: the FOB value in US dollars
- **freightUsd**: the freight cost in US dollars
- **insuranceUsd**: the insurance cost in US dollars
- **taxableUsd**: the taxable base in US dollars
- **taxableGuarani**: the taxable base in guaranies
- **dutyUsd**: the customs duty charged
- **exciseUsd**: the excise tax (ISC) charged
- **serviceFeeUsd**: the service fee charged
- **incomeTaxUsd**: the income tax advance charged
- **vatUsd**: the value added tax charged
- **otherTaxesUsd**: any other taxes charged
- **totalTaxesUsd**: the total of all taxes and charges on the line
- **subitemNumber\***: the subitem number within the tariff line
- **subitemQuantity\***: the subitem quantity
- **subitemUnitPrice\***: the subitem unit price
- **subitemDescription\***: the subitem description
- **subitemBrand\***: the subitem brand
- **url**: the DNA open-data portal the record was sourced from
- **observedAt**: when this record was last read by the scraper
*\*These fields only appear when Item-Level Detail is enabled.*
### Who is it for
| Use case | Who benefits |
|---|---|
| Tracking which companies and countries supply a given product into Paraguay | Importers and distributors |
| Sizing the market for an HS code by volume and declared value | Market analysts and consultants |
| Monitoring export flows of soybean, beef and other commodities | Commodity traders and exporters |
| Building tariff and landed-cost models from real duty and tax figures | Customs brokers and logistics teams |
| Feeding trade intelligence and lead-generation databases | B2B data and sales teams |
### Frequently Asked Questions
**What years and months of Paraguay customs data are available?**
The DNA open-data portal publishes one dataset per month from January 1997 through the most recent closed month. You pick the year and month in the input, and the scraper reads that exact dataset.
**How many records can I get from a single month?**
A single month can hold hundreds of thousands of tariff lines, so always set Max Items. The scraper streams the dataset and stops as soon as your limit is reached, so small pulls finish quickly even though the source files are very large.
**Can I filter by product, country or operation type?**
Yes. You can keep only imports or only exports, filter by an HS / NCM code prefix (a 2-digit chapter, a 4-digit heading or a longer code), filter by country of origin or destination, and filter by a merchandise keyword such as SOJA or NEUMATICOS.
**Does the data include the importer or exporter company name?**
No. The DNA open-data files identify each operation only by a ciphered dispatch id, not by company name, so the scraper returns the dispatch id rather than inventing a name. Every other shipment detail, including product, country, value and taxes, is present.
**What happens if no data exists for the year and month I pick?**
The scraper returns a single record with an error message explaining the dataset was not available, instead of failing silently, so you can adjust the year or month and run again.
### Export, API and AI agents (x402 + MCP)
Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.
For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [SUNAT Peru RUC Scraper](https://apify.com/scrapers_lat/sunat-scraper): Extract Peru SUNAT taxpayer records by RUC or company name: legal name, status, tax address, CIIU...
- [Colombia SECOP Scraper](https://apify.com/scrapers_lat/colombia-secop-scraper): Extract Colombia public contracts from SECOP II (datos.gov.co): entity and supplier, NIT, contract...
- [Chile Mercado Publico Supplier & Award Scraper](https://apify.com/scrapers_lat/mercado-publico-scraper): Extract Chile state suppliers from Mercado Publico and ChileProveedores with public-procurement...
- [BCRA Argentina Debtor & Credit Risk Scraper](https://apify.com/scrapers_lat/bcra-deudores-scraper): Extract Argentina BCRA Central de Deudores credit-risk records by CUIT or CUIL: debtor name...
- [DataJud Brazil Court Case Scraper](https://apify.com/scrapers_lat/datajud-scraper): Extract Brazilian court process records from the CNJ DataJud public database across 90+ federal...
- [SAT Mexico 69-B Taxpayer Blacklist Scraper](https://apify.com/scrapers_lat/sat-69b-scraper): Extract Mexico SAT Lista 69-B (EFOS) blacklist of taxpayers presumed or confirmed to issue fake...
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with the National Customs Directorate of Paraguay (DNA). It only accesses data that is publicly available on the official open-data portal. Use it in accordance with the portal's terms of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of shipment records to collect. A single month can contain hundreds of thousands of lines, so always set a limit. Optional.
## `withDetails` (type: `boolean`):
When enabled, the scraper reads the subitem-level dataset, which adds the subitem breakdown (subitem number, quantity, unit price, description, brand) on top of each tariff line. When disabled, it reads the item-level dataset (one record per tariff line, no subitem columns) which is smaller and faster.
## `year` (type: `string`):
Calendar year of the customs operations to download. The DNA open-data portal publishes monthly datasets from 1997 to the present.
## `month` (type: `string`):
Calendar month of the customs operations to download.
## `operation` (type: `string`):
Keep only import or only export operations. Leave on All to collect both.
## `hsCode` (type: `string`):
Keep only lines whose tariff position (NCM / Mercosur HS code) starts with this value. Accepts a chapter (2 digits, e.g. 85), heading (4 digits, e.g. 8544) or a longer prefix. Leave empty for all codes.
## `country` (type: `string`):
Keep only lines whose country of origin or country of provenance/destination contains this text (case-insensitive), for example BRASIL, CHINA or ARGENTINA. Leave empty for all countries.
## `keyword` (type: `string`):
Keep only lines whose merchandise description, tariff description or brand contains this text (case-insensitive), for example SOJA, NEUMATICOS or NOKIA. Leave empty for all goods.
## Actor input object example
```json
{
"maxItems": 10,
"withDetails": true,
"year": "2026",
"month": "ENERO",
"operation": "ALL"
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# 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 = {
"maxItems": 10
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/paraguay-customs-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 = { "maxItems": 10 }
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/paraguay-customs-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 '{
"maxItems": 10
}' |
apify call scrapers_lat/paraguay-customs-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/paraguay-customs-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Paraguay Customs Import/Export Records Scraper [🏷️ ON SALE 🎉]",
"description": "Extract shipment-level Paraguay customs import and export records from the official DNA open-data portal by year and month.",
"version": "0.1",
"x-build-id": "l8ER7RJEfTpiG5Njt"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~paraguay-customs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-paraguay-customs-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/scrapers_lat~paraguay-customs-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-paraguay-customs-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/scrapers_lat~paraguay-customs-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-paraguay-customs-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": [
"year",
"month"
],
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of shipment records to collect. A single month can contain hundreds of thousands of lines, so always set a limit. Optional."
},
"withDetails": {
"title": "Item-Level Detail",
"type": "boolean",
"description": "When enabled, the scraper reads the subitem-level dataset, which adds the subitem breakdown (subitem number, quantity, unit price, description, brand) on top of each tariff line. When disabled, it reads the item-level dataset (one record per tariff line, no subitem columns) which is smaller and faster.",
"default": true
},
"year": {
"title": "Year",
"enum": [
"1997",
"1998",
"1999",
"2000",
"2001",
"2002",
"2003",
"2004",
"2005",
"2006",
"2007",
"2008",
"2009",
"2010",
"2011",
"2012",
"2013",
"2014",
"2015",
"2016",
"2017",
"2018",
"2019",
"2020",
"2021",
"2022",
"2023",
"2024",
"2025",
"2026"
],
"type": "string",
"description": "Calendar year of the customs operations to download. The DNA open-data portal publishes monthly datasets from 1997 to the present.",
"default": "2026"
},
"month": {
"title": "Month",
"enum": [
"ENERO",
"FEBRERO",
"MARZO",
"ABRIL",
"MAYO",
"JUNIO",
"JULIO",
"AGOSTO",
"SEPTIEMBRE",
"OCTUBRE",
"NOVIEMBRE",
"DICIEMBRE"
],
"type": "string",
"description": "Calendar month of the customs operations to download.",
"default": "ENERO"
},
"operation": {
"title": "Operation Type",
"enum": [
"ALL",
"IMPORTACION",
"EXPORTACION"
],
"type": "string",
"description": "Keep only import or only export operations. Leave on All to collect both.",
"default": "ALL"
},
"hsCode": {
"title": "HS / NCM Code Prefix",
"type": "string",
"description": "Keep only lines whose tariff position (NCM / Mercosur HS code) starts with this value. Accepts a chapter (2 digits, e.g. 85), heading (4 digits, e.g. 8544) or a longer prefix. Leave empty for all codes."
},
"country": {
"title": "Country",
"type": "string",
"description": "Keep only lines whose country of origin or country of provenance/destination contains this text (case-insensitive), for example BRASIL, CHINA or ARGENTINA. Leave empty for all countries."
},
"keyword": {
"title": "Merchandise Keyword",
"type": "string",
"description": "Keep only lines whose merchandise description, tariff description or brand contains this text (case-insensitive), for example SOJA, NEUMATICOS or NOKIA. Leave empty for all goods."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```