Access to APIs and database

How do you access our data? Description of the API interfaces, usage, access levels and limitations of search queries.

Version 1 - Fulltext Search

Generic Get-Parameter
term Searchterm
lang Language (de, en, fr)
year Year (2013 - )

Code Number: /api/v1/cnSuggest 50 requests per Minute

Example: https://www.tariffnumber.com/api/v1/cnSuggest?term=8517
Example: https://www.tariffnumber.com/api/v1/cnSuggest?term=8517&lang=fr&year=2016

Offices: /api/v1/officesSuggest 50 requests per Minute

Example: https://www.tariffnumber.com/api/v1/officesSuggest?term=berlin

Definition of Terms: /api/v1/definitionsSuggest 50 requests per Minute

Example: https://www.tariffnumber.com/api/v1/definitionsSuggest?term=nace

Duties: /api/v1/cnDuties 5 requests per Minute

Example: https://www.tariffnumber.com/api/v1/cnDuties?term=17011290

Version 2 - Semantic Search (AI enhanced)

Generic Get-Parameter
term Searchterm
lang Language (de, en, fr)
(only current year)
Beta Status - allthough you often get better results compared to fulltext search, it might not work as expected. Due to the nature of AI training data, searchterms in English are recommended and will give you the best results.

Code Number: /api/v2/cnSuggest 5 requests per Minute

Example: https://www.tariffnumber.com/api/v2/cnSuggest?term=mp3 player&lang=en