UN Comtrade
Bounded official UN Comtrade preview queries you set
Monitor bounded official UN Comtrade preview queries for new, changed, or removed trade-flow records and generate source-linked trend reports and optional exports.
Not HTS tariff-rate changes (use HTS Tariff & Trade Scraper). Not BIS restricted-party lists. Not OFAC sanctions additions. You supply reporter/partner/HS watches.
from $6.00 / 1,000 Trade flow row ($0.006 per delivered trade-flow-row); $0.20 per Trade flow change alert; $12.00 per Trade trend report; $8.00 per Trade export. No Actor Start.
Open UN Comtrade Trade Flow Change Report on Apify
UN Comtrade Trade Flow Change Report, not a neighboring Actor
Use this page for this Actor’s job. Use HTS Tariff & Trade Scraper for HTS tariff changes; Use BIS Export Control List Change Report for BIS Entity/DPL/UVL lists; Use Sanctions Change Tracker for OFAC list additions/removals.
| This Actor | HTS Tariff & Trade Scraper | BIS Export Control List Change Report | Sanctions Change Tracker | |
|---|---|---|---|---|
| Intent | UN Comtrade flow changes for configured watches | HTS tariff changes | BIS Entity/DPL/UVL lists | OFAC list additions/removals |
| Primary input | watches | codes | watchlists | names |
| What it reads | Official UN Comtrade public preview API | Public HTS | BIS public lists | OFAC public lists |
| Primary output | Flow-row, change-alert, report, and export events | Tariff-change rows | List-change alerts | Sanctions-change rows |
| Not this job | Not HTS tariff-rate changes (use HTS Tariff & Trade Scraper). Not BIS restricted-party lists. Not OFAC sanctions additions. You supply reporter/partner/HS watches. | Not UN Comtrade flow tables. | Not Comtrade trade flows. | Not UN Comtrade flows. |
Store ID: taroyamada/un-comtrade-trade-flow-change-report. Respect source terms, robots.txt, and rate limits.
Use cases
- One reporter/HS watch with generateReport off first
- Use initialRunMode baseline_only to seed state
- Keep periods bounded
How is UN Comtrade Trade Flow Change Report different from HTS Tariff & Trade Scraper and BIS Export Control List Change Report?
UN Comtrade Trade Flow Change Report (taroyamada/un-comtrade-trade-flow-change-report): Monitor bounded official UN Comtrade preview queries for new, changed, or removed trade-flow records and generate source-linked trend reports and optional exports. Not HTS tariff-rate changes (use HTS Tariff & Trade Scraper). Not BIS restricted-party lists. Not OFAC sanctions additions. You supply reporter/partner/HS watches. HTS Tariff & Trade Scraper is for HTS tariff changes (input codes; Public HTS; Tariff-change rows). Not UN Comtrade flow tables. BIS Export Control List Change Report is for BIS Entity/DPL/UVL lists (input watchlists; BIS public lists; List-change alerts). Not Comtrade trade flows. Sanctions Change Tracker is for OFAC list additions/removals (input names; OFAC public lists; Sanctions-change rows). Not UN Comtrade flows.
What input is required?
Live required fields: watches. Published exampleRunInput is shown below.
| Field | Type | Default | Notes |
|---|---|---|---|
watches |
any[] | [] |
Trade-flow watches. Each watch creates at most one official preview API request. Duplicate query dimensions are fetched once and matched to all watch IDs. Required. |
monitorKey |
string | "un-comtrade-trade-flow-watch" |
Monitor key. Stable isolated state namespace for this recurring watch portfolio. |
initialRunMode |
string enum | "baseline_only" |
Initial run mode. baseline_only stores the first bounded snapshot with zero rows. emit_backfill emits the current changes for an explicit paid run. enum: baseline_only, emit_backfill |
generateReport |
boolean | true |
Generate trend report. Emit one report-first aggregate row when changes are observed. |
emitRawRows |
boolean | false |
Emit trade-flow rows. Emit one low-priced normalized row per changed current record. Report and alerts remain the primary output. |
emitExport |
boolean | false |
Generate export. Emit a compact source-linked JSON export when changes are observed. |
emitUnchanged |
boolean | false |
Emit unchanged records. Accepted for compatibility only. Unchanged runs always emit zero rows and zero charges. |
maxChargeUsd |
number | 35 |
Maximum charge USD. The complete planned PPE charge is estimated before the first dataset push. The run fails closed if this cap would be exceeded. minimum=0.006 maximum=500 |
requestTimeoutSeconds |
integer | 30 |
Request timeout seconds. Timeout for each official preview request. minimum=5 maximum=120 |
maxRetries |
integer | 3 |
Maximum retries. Bounded retries for 429 and transient 5xx responses only. minimum=0 maximum=4 |
dryRun |
boolean | false |
Dry run. Return deterministic representative report, alert, row, and export records without API calls, state writes, or charges. |
Published Store example run input (omitted fields take schema defaults):
{
"watches": [
{
"id": "japan-world-hs84-2023",
"reporterCode": "392",
"partnerCode": "0",
"hsCode": "84",
"flowCode": "X",
"frequency": "A",
"period": "2023"
}
],
"maxChargeUsd": 3,
"maxRetries": 3,
"dryRun": false
}Run UN Comtrade Trade Flow Change Report on Apify
How do dataset, webhook, and dry-run delivery work?
Dataset output is the billable surface when rows are written. See live PPE for which events bill. dryRun true validates or samples without the usual dataset/webhook side effects described on the Store schema. Unchanged runs that write zero default-dataset rows typically charge $0.00 on current PPE.
What does a result contain?
Published README Output Example / Sample Output JSON. Illustration: { "rowType": "trade_trend_report", "billingEventName": "trade-trend-report", "report": { "reportType": "bounded_trade_flow_change_report", "queryCount": 1, "changedRecordCount": 2, "newRecordCount": 1, "updatedRecordCount": 1, "removedRecordCount": 0, "byFlow": [ { "key": "X", "count": 2 } ], "coverageNote": "Official preview response only; one product and one period per request, max 500 records, not comprehensive trade data." } } Treat README samples as illustrations, not a live coverage guarantee. There is no published output JSON schema on the Store page.
How is UN Comtrade Trade Flow Change Report priced?
Billing is pay per event. The live Store card is from $6.00 / 1,000 Trade flow row ($0.006 per delivered trade-flow-row); $0.20 per Trade flow change alert; $12.00 per Trade trend report; $8.00 per Trade export. No Actor Start. Current PPE:
| Event | Price | Emitted when |
|---|---|---|
trade-flow-row (Trade flow row) |
$0.006 | Charged only when a trade flow row is delivered. |
trade-flow-change-alert (Trade flow change alert) |
$0.20 | Charged only when a trade flow change alert is delivered. |
trade-trend-report (Trade trend report) |
$12.00 | Charged only when a trade trend report is delivered. |
trade-export-generated (Trade export) |
$8.00 | Charged only when a trade export is delivered. |
from $6.00 / 1,000 Trade flow row ($0.006 per delivered trade-flow-row); $0.20 per Trade flow change alert; $12.00 per Trade trend report; $8.00 per Trade export. No Actor Start.
See UN Comtrade Trade Flow Change Report pricing on Apify
Limits to keep in mind
- watches required
- Public Comtrade preview only
- Report and export are opt-in
- Not a bulk full-history dump
- Respect source terms, robots.txt, and rate limits.
Open UN Comtrade Trade Flow Change Report on Apify
Related pages
- HTS Tariff & Trade Scraper — Not UN Comtrade flow tables.
- BIS Export Control List Change Report — Not Comtrade trade flows.
- Sanctions Change Tracker — Not UN Comtrade flows.
- Tools