Metadata recipes

The metadata category covers the reference catalogues: countries, partners, HS codes, units. Every recipe in this category is a beginner recipe that works without an API key.

ID	Title	Runtime	API key
RECIPE-001	List reporter countries	< 1 s	no
RECIPE-002	List partner countries	< 1 s	no
RECIPE-003	List HS codes at a level	< 1 s	no
RECIPE-004	Search HS codes by description	< 1 s	no
RECIPE-005	Refresh metadata catalogues	~ 5 s	no

Path

1. RECIPE-001 — List reporter countries. The simplest possible recipe; verify your install with this one.
2. RECIPE-002 — List partner countries.
3. RECIPE-003 — List HS codes at a level.
4. RECIPE-004 — Search HS codes by description.
5. RECIPE-005 — Refresh metadata catalogues.

Run them all

for recipe in recipes/metadata/*.py; do
    UN_COMTRADE_MOCK=1 python "$recipe"
done

Related Recipes

• RECIPE-001 — List reporter countries.
• RECIPE-002 — List partner countries.
• RECIPE-003 — List HS codes at a level.
• RECIPE-004 — Search HS codes by description.
• RECIPE-005 — Refresh metadata catalogues.

Related Guides

• Python SDK → Metadata — full Python API surface.
• CLI → Metadata — equivalent CLI commands.

Next steps

• Trade recipes — apply the catalogue to a real trade query.