Zugriff auf APIs und Datenbank

Wie erhalten Sie Zugriff auf unsere Daten? Beschreibung der API Schnittstellen, Nutzung, Zugriffsebenen und Limitierungen von Suchanfragen.

Version 1 - Fulltext Search

Traditional search using keyword matching, wildcards, and fuzzy search.

Documentation
OpenAPI Specification (YAML)
Parameters
term Search term (required)
lang Language: de, en, fr (default: de)
year Year: 2013 - 2026 (default: 2026)

Tariff Numbers /api/v1/cnSuggest 50 req/min

Search customs tariff numbers by code or description.

https://www1c.zolltarifnummern.de/api/v1/cnSuggest?term=8517
https://www1c.zolltarifnummern.de/api/v1/cnSuggest?term=8517&lang=fr&year=2016

Customs Offices /api/v1/officesSuggest 50 req/min

Search customs offices by reference number, city, or name.

https://www1c.zolltarifnummern.de/api/v1/officesSuggest?term=berlin

Definitions /api/v1/definitionsSuggest 50 req/min

Search customs-related terms and definitions.

https://www1c.zolltarifnummern.de/api/v1/definitionsSuggest?term=inflation

Duty Rates /api/v1/cnDuties 10 req/min

Get duty rates and trade measures for a tariff number.

https://www1c.zolltarifnummern.de/api/v1/cnDuties?term=17011290

Version 2 - Semantic Search AI-powered

AI-powered semantic search using vector embeddings. Understands meaning and context, not just keywords.

Advantages over V1:

  • Finds results even without exact keyword matches
  • Understands synonyms and related terms
  • Maps everyday language to official customs terminology
Documentation
OpenAPI Specification (YAML)
Parameters
term Search term (required)
lang Language: de, en, fr (default: de)

Only current year (2026) available. For best results, use English search terms.

Tariff Numbers /api/v2/cnSuggest 5 req/min

Semantic search for customs tariff numbers. Try everyday terms like "laptop" or "smartphone".

https://www1c.zolltarifnummern.de/api/v2/cnSuggest?term=laptop computer&lang=en
https://www1c.zolltarifnummern.de/api/v2/cnSuggest?term=fresh beef&lang=en
https://www1c.zolltarifnummern.de/api/v2/cnSuggest?term=Lederschuhe&lang=de