Paraguay Customs Data Scraper: Imports, Exports and NCM Trade Data

Extract shipment-level Paraguay customs data (foreign-trade / comercio exterior) straight from the official DNA open-data portal (Dirección Nacional de Aduanas, aduana.gov.py). Get every import and export tariff line for any month from 1997 to today: HS / NCM tariff code, goods description, country of origin and destination, FOB and CIF value, weights, exchange rate and the full customs tax and duty breakdown. No API key, no browser, no login.

Here is one real import record with every field the actor returns:

{
  "operation": "IMPORTACION",
  "dispatchId": "25DA000000098986",
  "itemNumber": 1,
  "regimeCode": "IC04",
  "regime": "IMPORTACION A CONSUMO CON DOCUMENTO DE TRANSPORTE",
  "customsOffice": "CAACUPEMI",
  "officializationDate": "2025-03-14",
  "clearanceDate": "2025-03-14",
  "year": "2025",
  "month": "MARZO",
  "transportMode": "CAMION",
  "channel": "V",
  "usdGuaraniRate": 7954.54,
  "hsCode": "5911.90.00.000U",
  "ncmCode": "59119000",
  "hsChapter": "59",
  "hsHeading": "5911",
  "tariffGroup": "MANUFACTURAS DE TEJIDOS ( PRENDAS Y COMPLEMENTOS DE VESTIR)",
  "chapterDescription": "CAPITULO 59 TEJIDOS IMPREGNADOS, RECUBIERTOS, REVESTIDOS O ESTRATIFICADOS; ARTICULOS TECNICOS DE MATERIAS TEXTILES.",
  "headingDescription": "Full official tariff heading text (trimmed here for readability).",
  "positionDescription": "Full official tariff position text (trimmed here for readability).",
  "merchandise": "P032558 016 210 FT/LP POLYESTER SINGED BAG 149 MM OD X 3670 MM L",
  "brand": "DONALDSON",
  "tradeAgreement": "SIN ACUERDO",
  "condition": "NUEVO",
  "countryOfOrigin": "MEXICO",
  "countryOfProvenanceDestination": "MEXICO",
  "statisticalUnit": "METROS",
  "statisticalQuantity": 600,
  "netWeightKg": 720,
  "grossWeightKg": 772,
  "fobUsd": 15000,
  "freightUsd": 4953,
  "insuranceUsd": 150,
  "cifUsd": 20103,
  "adjustmentToIncludeUsd": 0,
  "adjustmentToDeductUsd": 0,
  "taxableUsd": 20103,
  "taxableGuarani": 159910117.62,
  "dutyGuarani": 25585619,
  "exciseGuarani": 0,
  "serviceFeeGuarani": 799551,
  "incomeTaxGuarani": 0,
  "vatGuarani": 18629529,
  "otherTaxesGuarani": 745181,
  "totalTaxesGuarani": 45759880,
  "subitemNumber": "0",
  "subitemQuantity": 0,
  "subitemUnitPrice": 0,
  "subitemDescription": null,
  "subitemBrand": null,
  "url": "https://datosabiertos.aduana.gov.py/ddaa/app/index.html",
  "observedAt": "2026-09-06T00:00:00.000Z",
  "error": null
}

The most complete Paraguay customs (DNA) scraper available. It returns every field the official DNA open-data portal exposes for each import and export tariff line, including full valuation and customs tax columns and an optional subitem breakdown, and gives you operation, HS / NCM code, country, customs office, regime, date-range and keyword filters to target exactly the shipments you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Why this scraper
• Quickstart
• Input reference
• Output reference
• How it compares
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor reads Paraguay's official DNA (Dirección Nacional de Aduanas) open-data customs datasets for the year and month you pick, streams the tariff lines, applies your filters, and writes one normalized record per line to the run's dataset. Each record carries the dispatch and customs regime, customs office, dates, transport mode, tariff position (NCM / Mercosur HS code) with the 2, 4 and 8-digit breakdown, tariff group, goods description, brand, country of origin and provenance/destination, full valuation (FOB, freight, insurance, computed CIF, value adjustments, taxable value in USD and guaraníes) and every customs tax column (duty, excise/ISC, service fee, income tax, VAT/IVA, other, total). With subitem detail on it also reads the subitem-level dataset for the per-subitem breakdown. Missing source values are returned as null, never invented.

The DNA portal publishes monthly datasets from 1997 to the present. A single month can contain hundreds of thousands of lines, so always set maxShipments.

Use cases

• Trade intelligence and market sizing: measure import and export volumes and values by HS / NCM code, country and month.
• Competitor and supplier monitoring: track goods, brands and origin countries moving through a tariff position.
• Customs and tax analysis: read the full duty, excise, VAT and total-tax breakdown per shipment line.
• Logistics and sourcing: filter by customs office, transport mode and regime to model trade routes into and out of Paraguay.
• KYB and compliance enrichment for foreign-trade due diligence in Paraguay.

Why this scraper

• Only dedicated Paraguay source. It is the only Apify actor that covers Paraguay customs (DNA) trade data. General customs actors cover India, the US or Taiwan, not Paraguay.
• Complete field set. Every source column is mapped, including valuation, value adjustments and the full customs tax breakdown, plus derived NCM / HS chapter and heading codes and a computed CIF value.
• Powerful filters. Operation, HS / NCM prefix, country, merchandise keyword, customs office, regime and officialization date range.
• Honest nulls. Fields absent in the source are returned as null. See the note on importer identity below.

Note on importer / exporter identity. Paraguay's public open-data customs files identify each shipment only by a ciphered dispatch id (dispatchId, "despacho cifrado"). The company name and RUC (tax id) of the importer or exporter are not published in the open dataset, so they cannot be returned. Every other shipment detail (goods, HS / NCM code, country, value, weight, taxes) is present and returned.

Quickstart

Open the actor, paste this into the input, and press Run. It returns 10 shipment lines from January 2026 with subitem detail (subitem detail requires a paid Apify plan).

{
  "maxShipments": 10,
  "withDetails": true,
  "year": "2026",
  "month": "ENERO",
  "operation": "ALL"
}

year and month are required. Narrow the pull with operation, hsCode, country, keyword, office, regime, dateFrom and dateTo.

Input reference

Field	Type	Required	Default	Description
maxShipments	integer	no	10	Maximum shipment records to collect (1 to 1000000). Always set a limit; a single month can be very large.
withDetails	boolean	no	true	Read the subitem-level dataset (adds subitem number, quantity, unit price, description, brand). Paid Apify plans only; free plans always read the item-level dataset.
year	enum	yes	2026	Calendar year of the customs operations. 1997 to 2026.
month	enum	yes	ENERO	Calendar month (ENERO to DICIEMBRE).
operation	enum	no	ALL	Keep only IMPORTACION (imports), EXPORTACION (exports), or ALL.
hsCode	string	no	(empty)	Keep only lines whose tariff position (NCM / Mercosur HS code) starts with this value. Chapter (2 digits), heading (4 digits), or longer prefix.
country	string	no	(empty)	Keep only lines whose country of origin or provenance/destination contains this text (case-insensitive), for example BRASIL, CHINA.
keyword	string	no	(empty)	Keep only lines whose merchandise, tariff description, or brand contains this text (case-insensitive), for example SOJA, NEUMATICOS, NOKIA.
office	string	no	(empty)	Keep only lines cleared at a customs office whose name contains this text, for example CIUDAD DEL ESTE, ASUNCION.
regime	string	no	(empty)	Keep only lines whose customs regime code or description contains this text, for example IC04, CONSUMO.
dateFrom	string	no	(empty)	Keep only lines officialized on or after this date (YYYY-MM-DD).
dateTo	string	no	(empty)	Keep only lines officialized on or before this date (YYYY-MM-DD).

Output reference

One dataset item per tariff line. Types: string, number, integer, or null when the source value is absent.

Field	Type	Description
operation	string	Operation type: IMPORTACION or EXPORTACION.
dispatchId	string	Ciphered customs dispatch (despacho) identifier.
itemNumber	integer	Item number within the dispatch.
regimeCode	string	Customs regime code.
regime	string	Customs regime description.
customsOffice	string	Customs office (aduana).
officializationDate	string	Officialization date (YYYY-MM-DD).
clearanceDate	string	Clearance / dispatch date (YYYY-MM-DD).
year	string	Dataset year.
month	string	Dataset month.
transportMode	string	Transport mode, for example CAMION, ACUATICO, AVION.
channel	string	Inspection channel code.
usdGuaraniRate	number	USD to guaraní exchange rate applied.
hsCode	string	Full tariff position (NCM / Mercosur HS code).
ncmCode	string	8-digit Mercosur NCM code derived from the tariff position.
hsChapter	string	2-digit HS chapter.
hsHeading	string	4-digit HS heading.
tariffGroup	string	Tariff group (rubro).
chapterDescription	string	HS chapter description.
headingDescription	string	HS heading description.
positionDescription	string	Full tariff position description.
merchandise	string	Free-text merchandise description.
brand	string	Brand of the goods.
tradeAgreement	string	Trade agreement applied, for example SIN ACUERDO, MERCOSUR.
condition	string	Condition of goods, for example NUEVO.
countryOfOrigin	string	Country of origin.
countryOfProvenanceDestination	string	Country of provenance (imports) or destination (exports).
statisticalUnit	string	Statistical unit of measure.
statisticalQuantity	number	Statistical quantity.
netWeightKg	number	Net weight in kilograms.
grossWeightKg	number	Gross weight in kilograms.
fobUsd	number	FOB value in USD.
freightUsd	number	Freight value in USD.
insuranceUsd	number	Insurance value in USD.
cifUsd	number	CIF value in USD, computed as FOB plus freight plus insurance.
adjustmentToIncludeUsd	number	Customs value adjustment to include, in USD.
adjustmentToDeductUsd	number	Customs value adjustment to deduct, in USD.
taxableUsd	number	Taxable customs value in USD.
taxableGuarani	number	Taxable customs value in guaraníes.
dutyGuarani	number	Import duty in guaraníes (PYG).
exciseGuarani	number	Excise (ISC) tax in guaraníes (PYG).
serviceFeeGuarani	number	Customs service fee in guaraníes (PYG).
incomeTaxGuarani	number	Income tax withholding in guaraníes (PYG).
vatGuarani	number	VAT (IVA) in guaraníes (PYG).
otherTaxesGuarani	number	Other taxes in guaraníes (PYG).
totalTaxesGuarani	number	Total taxes in guaraníes (PYG).
subitemNumber	string	Subitem number (with subitem detail on).
subitemQuantity	number	Subitem quantity.
subitemUnitPrice	number	Subitem unit price.
subitemDescription	string	Subitem description, or null.
subitemBrand	string	Subitem brand, or null.
url	string	Source DNA open-data portal URL.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Currency note. Values named ...Usd are in US dollars and values named ...Guarani are in Paraguayan guaraníes, exactly as the official source publishes them. The customs tax and duty columns are settled in guaraníes; divide by usdGuaraniRate for a USD estimate.

How it compares

No other actor covers Paraguay customs. The nearest customs and trade-data actors cover other countries; against them this actor is a strict superset for Paraguay.

Capability	This actor (Paraguay)	Zauba (India)	ImportYeti / Bill of Lading (US)	Taiwan customs
Paraguay DNA coverage	Yes, 1997 to today	No	No	No
Import and export lines	Both	Import focus	Import focus	Export focus
HS / NCM + 2/4/8-digit breakdown	Yes	HS only	HS only	HS only
FOB, freight, insurance, CIF	Yes	Partial	Partial	Partial
Full customs tax and duty breakdown	Yes (7 columns)	No	No	No
Subitem breakdown	Yes	No	No	No
Filters (operation, HS, country, office, regime, date, keyword)	8 filters	Fewer	Fewer	Fewer
No API key	Yes	Varies	Varies	Varies

Named actors for reference: trev0n/zauba-scraper, jungle_synthesizer/importyeti-bill-of-lading-scraper, fortuitous_pirate/bill-of-lading-scraper, nexgendata/taiwan-customs-export-trade-data. None return Paraguay data.

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~paraguay-customs-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"year":"2026","month":"ENERO","operation":"IMPORTACION","maxShipments":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~paraguay-customs-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"year":"2025","month":"MARZO","hsCode":"1201","country":"BRASIL","keyword":"SOJA","maxShipments":100}'

Apify CLI:

apify call scrapers_lat/paraguay-customs-scraper \
  --input '{"year":"2026","month":"ENERO","operation":"EXPORTACION"}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per shipment line returned (result event). With subitem detail on, paid plans are also charged the details add-on once per line that carries a subitem breakdown, after that line is written. See the pricing tab for current prices.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 shipment lines per run and read the item-level dataset only. Upgrade for higher maxShipments and subitem detail.

FAQ and troubleshooting

A run returned 0 records. Why? The filters matched nothing in the chosen month, or the month has not been published yet. Widen the filters or pick another month. Zero-result runs are not charged.

Does it include the importer or exporter company name and RUC? No. Paraguay's public open-data files identify each shipment only by a ciphered dispatch id; the company name and RUC are not published there, so they cannot be returned. All other shipment detail is included.

How big is one month? A single month can contain hundreds of thousands of tariff lines, so always set maxShipments and use filters to keep runs efficient.

What does subitem detail add? It reads the subitem-level dataset, adding the per-subitem breakdown (subitemNumber, subitemQuantity, subitemUnitPrice, subitemDescription, subitemBrand) on top of each tariff line. It requires a paid Apify plan.

Are the tax amounts in dollars? No. FOB, freight, insurance, CIF and the taxable value are provided in USD (fields ending in Usd). The customs tax and duty columns are settled in guaraníes (fields ending in Guarani). Divide by usdGuaraniRate for a USD estimate.

Why do some descriptions contain a ¿ character? That is an encoding artifact in the official DNA source data. The actor returns the text exactly as published, without altering it.

How do I track a single product or country of trade? Combine hsCode (tariff prefix), country, and keyword. For example, soy exports to Brazil: {"operation":"EXPORTACION","hsCode":"1201","country":"BRASIL"}.

Is this an official government tool? No. This actor is independent and reads only the publicly available DNA open-data portal. Use the results in accordance with the source's terms and applicable laws.

Related scrapers

• Paraguay DNCP Public Procurement Scraper: Paraguay public tenders and contracts.
• Brazil Import and Export Trade Data Scraper: Brazilian foreign-trade data by HS code and country.
• Colombia SECOP Scraper: Colombian public contracts.
• UN Comtrade Trade Data Scraper: Global bilateral trade statistics.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

Independent tool, not affiliated with the Dirección Nacional de Aduanas of Paraguay. Accesses only publicly available open-data customs records. Use the results in accordance with the source's terms and applicable laws.

---

Scraper de Datos de Aduana de Paraguay: Importaciones, Exportaciones y NCM

Extrae datos de aduana de Paraguay a nivel de embarque (comercio exterior) directamente del portal oficial de datos abiertos de la DNA (Dirección Nacional de Aduanas, aduana.gov.py). Obtén cada línea arancelaria de importación y exportación de cualquier mes desde 1997 hasta hoy: código arancelario HS / NCM, descripción de la mercadería, país de origen y destino, valor FOB y CIF, pesos, cotización y el desglose completo de tributos y aranceles aduaneros. Sin clave API, sin navegador, sin inicio de sesión.

Aquí tienes un registro real de importación con todos los campos que devuelve el actor:

{
  "operation": "IMPORTACION",
  "dispatchId": "25DA000000098986",
  "itemNumber": 1,
  "regimeCode": "IC04",
  "regime": "IMPORTACION A CONSUMO CON DOCUMENTO DE TRANSPORTE",
  "customsOffice": "CAACUPEMI",
  "officializationDate": "2025-03-14",
  "clearanceDate": "2025-03-14",
  "year": "2025",
  "month": "MARZO",
  "transportMode": "CAMION",
  "channel": "V",
  "usdGuaraniRate": 7954.54,
  "hsCode": "5911.90.00.000U",
  "ncmCode": "59119000",
  "hsChapter": "59",
  "hsHeading": "5911",
  "tariffGroup": "MANUFACTURAS DE TEJIDOS ( PRENDAS Y COMPLEMENTOS DE VESTIR)",
  "chapterDescription": "CAPITULO 59 TEJIDOS IMPREGNADOS, RECUBIERTOS, REVESTIDOS O ESTRATIFICADOS; ARTICULOS TECNICOS DE MATERIAS TEXTILES.",
  "headingDescription": "Texto arancelario oficial completo (recortado aquí para lectura).",
  "positionDescription": "Texto arancelario oficial completo (recortado aquí para lectura).",
  "merchandise": "P032558 016 210 FT/LP POLYESTER SINGED BAG 149 MM OD X 3670 MM L",
  "brand": "DONALDSON",
  "tradeAgreement": "SIN ACUERDO",
  "condition": "NUEVO",
  "countryOfOrigin": "MEXICO",
  "countryOfProvenanceDestination": "MEXICO",
  "statisticalUnit": "METROS",
  "statisticalQuantity": 600,
  "netWeightKg": 720,
  "grossWeightKg": 772,
  "fobUsd": 15000,
  "freightUsd": 4953,
  "insuranceUsd": 150,
  "cifUsd": 20103,
  "adjustmentToIncludeUsd": 0,
  "adjustmentToDeductUsd": 0,
  "taxableUsd": 20103,
  "taxableGuarani": 159910117.62,
  "dutyGuarani": 25585619,
  "exciseGuarani": 0,
  "serviceFeeGuarani": 799551,
  "incomeTaxGuarani": 0,
  "vatGuarani": 18629529,
  "otherTaxesGuarani": 745181,
  "totalTaxesGuarani": 45759880,
  "subitemNumber": "0",
  "subitemQuantity": 0,
  "subitemUnitPrice": 0,
  "subitemDescription": null,
  "subitemBrand": null,
  "url": "https://datosabiertos.aduana.gov.py/ddaa/app/index.html",
  "observedAt": "2026-09-06T00:00:00.000Z",
  "error": null
}

El scraper de aduana (DNA) de Paraguay más completo disponible. Devuelve todos los campos que el portal oficial de datos abiertos de la DNA expone para cada línea arancelaria de importación y exportación, incluidas las columnas completas de valoración y tributos aduaneros y un desglose opcional por subítem, y te da filtros por operación, código HS / NCM, país, aduana, régimen, rango de fechas y palabra clave para apuntar exactamente a los embarques que necesitas.

📥 Entrada · 📤 Salida · 💰 Precios · ▶️ Ejemplos

Tabla de contenidos

• Qué hace
• Por qué este scraper
• Inicio rápido
• Referencia de entrada
• Referencia de salida
• Comparativa
• Ejecutar por API y CLI
• Obtener resultados
• Facturación y límites
• Preguntas frecuentes

Qué hace

El actor lee los conjuntos de datos abiertos de aduana de la DNA (Dirección Nacional de Aduanas) de Paraguay para el año y mes que elijas, transmite las líneas arancelarias, aplica tus filtros y escribe un registro normalizado por línea en el dataset de la ejecución. Cada registro incluye el despacho y el régimen aduanero, la aduana, las fechas, el medio de transporte, la posición arancelaria (código HS / NCM del Mercosur) con el desglose de 2, 4 y 8 dígitos, el rubro, la descripción de la mercadería, la marca, el país de origen y el de procedencia/destino, la valoración completa (FOB, flete, seguro, CIF calculado, ajustes de valor, valor imponible en USD y en guaraníes) y todas las columnas de tributos aduaneros (derecho, ISC, servicio, renta, IVA, otros, total). Con el detalle de subítem activado también lee el conjunto de datos a nivel de subítem. Los valores ausentes en la fuente se devuelven como null, nunca se inventan.

El portal de la DNA publica conjuntos de datos mensuales desde 1997 hasta hoy. Un solo mes puede contener cientos de miles de líneas, así que fija siempre maxShipments.

Casos de uso

• Inteligencia comercial y dimensionamiento de mercado: medir volúmenes y valores de importación y exportación por código HS / NCM, país y mes.
• Monitoreo de competidores y proveedores: seguir mercaderías, marcas y países de origen que mueven una posición arancelaria.
• Análisis aduanero y tributario: leer el desglose completo de derecho, ISC, IVA y total de tributos por línea de embarque.
• Logística y abastecimiento: filtrar por aduana, medio de transporte y régimen para modelar rutas comerciales hacia y desde Paraguay.
• Enriquecimiento KYB y de cumplimiento para debida diligencia de comercio exterior en Paraguay.

Por qué este scraper

• Única fuente dedicada a Paraguay. Es el único actor de Apify que cubre los datos de aduana (DNA) de Paraguay. Los actores de aduana generales cubren India, EE. UU. o Taiwán, no Paraguay.
• Conjunto de campos completo. Se mapea cada columna de la fuente, incluidas la valoración, los ajustes de valor y el desglose completo de tributos, más los códigos NCM / capítulo y partida HS derivados y un valor CIF calculado.
• Filtros potentes. Operación, prefijo HS / NCM, país, palabra clave de mercadería, aduana, régimen y rango de fecha de oficialización.
• Nulos honestos. Los campos ausentes en la fuente se devuelven como null. Ver la nota sobre la identidad del importador más abajo.

Nota sobre la identidad del importador / exportador. Los archivos públicos de datos abiertos de aduana de Paraguay identifican cada embarque solo con un despacho cifrado (dispatchId). El nombre de la empresa y el RUC (identificación tributaria) del importador o exportador no se publican en el conjunto de datos abierto, por lo que no se pueden devolver. Todo el resto del detalle del embarque (mercadería, código HS / NCM, país, valor, peso, tributos) está presente y se devuelve.

Inicio rápido

Abre el actor, pega esto en la entrada y presiona Run. Devuelve 10 líneas de embarque de enero de 2026 con detalle de subítem (el detalle de subítem requiere un plan de pago de Apify).

{
  "maxShipments": 10,
  "withDetails": true,
  "year": "2026",
  "month": "ENERO",
  "operation": "ALL"
}

year y month son obligatorios. Acota la extracción con operation, hsCode, country, keyword, office, regime, dateFrom y dateTo.

Referencia de entrada

Campo	Tipo	Obligatorio	Predet.	Descripción
maxShipments	integer	no	10	Máximo de registros de embarque a recolectar (1 a 1000000). Fija siempre un límite; un mes puede ser muy grande.
withDetails	boolean	no	true	Leer el conjunto a nivel de subítem (agrega número, cantidad, precio unitario, descripción y marca de subítem). Solo planes de pago; los planes gratuitos leen siempre el conjunto a nivel de ítem.
year	enum	sí	2026	Año calendario de las operaciones aduaneras. 1997 a 2026.
month	enum	sí	ENERO	Mes calendario (ENERO a DICIEMBRE).
operation	enum	no	ALL	Mantener solo IMPORTACION, EXPORTACION o ALL.
hsCode	string	no	(vacío)	Mantener solo líneas cuya posición arancelaria (código HS / NCM del Mercosur) empiece por este valor. Capítulo (2 dígitos), partida (4 dígitos) o prefijo más largo.
country	string	no	(vacío)	Mantener solo líneas cuyo país de origen o procedencia/destino contenga este texto (sin distinción de mayúsculas), por ejemplo BRASIL, CHINA.
keyword	string	no	(vacío)	Mantener solo líneas cuya mercadería, descripción arancelaria o marca contenga este texto, por ejemplo SOJA, NEUMATICOS, NOKIA.
office	string	no	(vacío)	Mantener solo líneas despachadas en una aduana cuyo nombre contenga este texto, por ejemplo CIUDAD DEL ESTE, ASUNCION.
regime	string	no	(vacío)	Mantener solo líneas cuyo código o descripción de régimen aduanero contenga este texto, por ejemplo IC04, CONSUMO.
dateFrom	string	no	(vacío)	Mantener solo líneas oficializadas en o después de esta fecha (YYYY-MM-DD).
dateTo	string	no	(vacío)	Mantener solo líneas oficializadas en o antes de esta fecha (YYYY-MM-DD).

Referencia de salida

Un ítem de dataset por línea arancelaria. Tipos: string, number, integer o null cuando el valor de la fuente está ausente.

Campo	Tipo	Descripción
operation	string	Tipo de operación: IMPORTACION o EXPORTACION.
dispatchId	string	Identificador de despacho aduanero cifrado.
itemNumber	integer	Número de ítem dentro del despacho.
regimeCode	string	Código del régimen aduanero.
regime	string	Descripción del régimen aduanero.
customsOffice	string	Aduana.
officializationDate	string	Fecha de oficialización (YYYY-MM-DD).
clearanceDate	string	Fecha de cancelación / despacho (YYYY-MM-DD).
year	string	Año del conjunto de datos.
month	string	Mes del conjunto de datos.
transportMode	string	Medio de transporte, por ejemplo CAMION, ACUATICO, AVION.
channel	string	Código de canal de inspección.
usdGuaraniRate	number	Cotización USD a guaraní aplicada.
hsCode	string	Posición arancelaria completa (código HS / NCM del Mercosur).
ncmCode	string	Código NCM del Mercosur de 8 dígitos derivado de la posición arancelaria.
hsChapter	string	Capítulo HS de 2 dígitos.
hsHeading	string	Partida HS de 4 dígitos.
tariffGroup	string	Rubro arancelario.
chapterDescription	string	Descripción del capítulo HS.
headingDescription	string	Descripción de la partida HS.
positionDescription	string	Descripción completa de la posición arancelaria.
merchandise	string	Descripción libre de la mercadería.
brand	string	Marca de la mercadería.
tradeAgreement	string	Acuerdo comercial aplicado, por ejemplo SIN ACUERDO, MERCOSUR.
condition	string	Condición de la mercadería, por ejemplo NUEVO.
countryOfOrigin	string	País de origen.
countryOfProvenanceDestination	string	País de procedencia (importaciones) o destino (exportaciones).
statisticalUnit	string	Unidad de medida estadística.
statisticalQuantity	number	Cantidad estadística.
netWeightKg	number	Peso neto en kilogramos.
grossWeightKg	number	Peso bruto en kilogramos.
fobUsd	number	Valor FOB en USD.
freightUsd	number	Valor de flete en USD.
insuranceUsd	number	Valor de seguro en USD.
cifUsd	number	Valor CIF en USD, calculado como FOB más flete más seguro.
adjustmentToIncludeUsd	number	Ajuste de valor a incluir, en USD.
adjustmentToDeductUsd	number	Ajuste de valor a deducir, en USD.
taxableUsd	number	Valor imponible aduanero en USD.
taxableGuarani	number	Valor imponible aduanero en guaraníes.
dutyGuarani	number	Derecho de importación en guaraníes (PYG).
exciseGuarani	number	Impuesto selectivo (ISC) en guaraníes (PYG).
serviceFeeGuarani	number	Tasa de servicio aduanero en guaraníes (PYG).
incomeTaxGuarani	number	Retención de renta en guaraníes (PYG).
vatGuarani	number	IVA en guaraníes (PYG).
otherTaxesGuarani	number	Otros tributos en guaraníes (PYG).
totalTaxesGuarani	number	Total de tributos en guaraníes (PYG).
subitemNumber	string	Número de subítem (con detalle de subítem activado).
subitemQuantity	number	Cantidad del subítem.
subitemUnitPrice	number	Precio unitario del subítem.
subitemDescription	string	Descripción del subítem, o null.
subitemBrand	string	Marca del subítem, o null.
url	string	URL del portal de datos abiertos de la DNA.
observedAt	string	Marca de tiempo ISO 8601 de la recolección del registro.
error	string	null en éxito. En una ejecución fallida se escribe un único ítem con el campo error poblado.

Nota sobre monedas. Los valores con nombre ...Usd están en dólares estadounidenses y los valores con nombre ...Guarani están en guaraníes paraguayos, tal como los publica la fuente oficial. Las columnas de tributos y aranceles se liquidan en guaraníes; divide por usdGuaraniRate para una estimación en USD.

Comparativa

Ningún otro actor cubre la aduana de Paraguay. Los actores de aduana y datos comerciales más cercanos cubren otros países; frente a ellos este actor es un superconjunto estricto para Paraguay.

Capacidad	Este actor (Paraguay)	Zauba (India)	ImportYeti / Bill of Lading (EE. UU.)	Aduana de Taiwán
Cobertura DNA de Paraguay	Sí, 1997 a hoy	No	No	No
Líneas de importación y exportación	Ambas	Enfoque importación	Enfoque importación	Enfoque exportación
HS / NCM + desglose 2/4/8 dígitos	Sí	Solo HS	Solo HS	Solo HS
FOB, flete, seguro, CIF	Sí	Parcial	Parcial	Parcial
Desglose completo de tributos y aranceles	Sí (7 columnas)	No	No	No
Desglose por subítem	Sí	No	No	No
Filtros (operación, HS, país, aduana, régimen, fecha, palabra clave)	8 filtros	Menos	Menos	Menos
Sin clave API	Sí	Varía	Varía	Varía

Actores nombrados como referencia: trev0n/zauba-scraper, jungle_synthesizer/importyeti-bill-of-lading-scraper, fortuitous_pirate/bill-of-lading-scraper, nexgendata/taiwan-customs-export-trade-data. Ninguno devuelve datos de Paraguay.

Ejecutar por API y CLI

Inicia una ejecución y espera a que termine, luego lee el dataset. Reemplaza <TOKEN> por tu token de API de Apify.

Ejecutar de forma síncrona y obtener los ítems en una sola llamada:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~paraguay-customs-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"year":"2026","month":"ENERO","operation":"IMPORTACION","maxShipments":25}'

Iniciar una ejecución de forma asíncrona:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~paraguay-customs-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"year":"2025","month":"MARZO","hsCode":"1201","country":"BRASIL","keyword":"SOJA","maxShipments":100}'

Apify CLI:

apify call scrapers_lat/paraguay-customs-scraper \
  --input '{"year":"2026","month":"ENERO","operation":"EXPORTACION"}'

Obtener resultados

Cada ejecución escribe en un dataset. Obtén los ítems como JSON, CSV o Excel cambiando format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginar datasets grandes
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> se devuelve como defaultDatasetId en el objeto de la ejecución. Usa offset y limit para paginar. clean=true descarta campos vacíos e internos.

Facturación y límites

• Pago por resultado. Se cobra por línea de embarque devuelta (evento result). Con el detalle de subítem activado, los planes de pago también pagan el complemento details una vez por línea que lleva desglose de subítem, después de escribir esa línea. Consulta la pestaña de precios.
• Sin cargo en caso de fallo. Si una ejecución falla, el actor escribe un único ítem con el campo error poblado y no cobra por él. Las ejecuciones vacías no cuestan nada.
• Límite de gasto respetado. Fija maxTotalChargeUsd en la ejecución; al alcanzarlo, el actor deja de emitir y cobrar resultados facturables.
• Los planes gratuitos de Apify están limitados a 10 líneas de embarque por ejecución y leen solo el conjunto a nivel de ítem. Mejora tu plan para más maxShipments y detalle de subítem.

Preguntas frecuentes

Una ejecución devolvió 0 registros. ¿Por qué? Los filtros no coincidieron con nada en el mes elegido, o el mes aún no se publicó. Amplía los filtros o elige otro mes. Las ejecuciones sin resultados no se cobran.

¿Incluye el nombre y el RUC de la empresa importadora o exportadora? No. Los archivos públicos de datos abiertos de Paraguay identifican cada embarque solo con un despacho cifrado; el nombre de la empresa y el RUC no se publican allí, por lo que no se pueden devolver. Todo el resto del detalle del embarque está incluido.

¿Qué tan grande es un mes? Un solo mes puede contener cientos de miles de líneas arancelarias, así que fija siempre maxShipments y usa filtros para que las ejecuciones sean eficientes.

¿Qué agrega el detalle de subítem? Lee el conjunto a nivel de subítem, agregando el desglose por subítem (subitemNumber, subitemQuantity, subitemUnitPrice, subitemDescription, subitemBrand) sobre cada línea arancelaria. Requiere un plan de pago de Apify.

¿Los montos de tributos están en dólares? No. FOB, flete, seguro, CIF y el valor imponible se entregan en USD (campos terminados en Usd). Las columnas de tributos y aranceles se liquidan en guaraníes (campos terminados en Guarani). Divide por usdGuaraniRate para una estimación en USD.

¿Por qué algunas descripciones contienen un carácter ¿? Es un artefacto de codificación en los datos oficiales de la DNA. El actor devuelve el texto exactamente como se publica, sin alterarlo.

¿Cómo sigo un solo producto o país de comercio? Combina hsCode (prefijo arancelario), country y keyword. Por ejemplo, exportaciones de soja a Brasil: {"operation":"EXPORTACION","hsCode":"1201","country":"BRASIL"}.

¿Es una herramienta oficial del gobierno? No. Este actor es independiente y lee solo el portal público de datos abiertos de la DNA. Usa los resultados conforme a los términos de la fuente y las leyes aplicables.

Scrapers relacionados

• Scraper de Contrataciones Públicas DNCP de Paraguay: licitaciones y contratos públicos de Paraguay.
• Scraper de Datos de Comercio Exterior de Brasil: datos de comercio exterior de Brasil por código HS y país.
• Scraper SECOP de Colombia: contratos públicos de Colombia.
• Scraper de Datos de Comercio UN Comtrade: estadísticas de comercio bilateral global.

Más scrapers en scrapers.lat

Creado y mantenido por scrapers.lat, donde publicamos scrapers para plataformas públicas de EE. UU. y América Latina: registros de empresas, datos de gobierno, finanzas, comercio electrónico y más. Explora el catálogo o solicita un scraper a medida en scrapers.lat.

Herramienta independiente, no afiliada a la Dirección Nacional de Aduanas de Paraguay. Accede solo a registros aduaneros de datos abiertos disponibles públicamente. Usa los resultados conforme a los términos de la fuente y las leyes aplicables.