Interactive Data Dissemination Service for Trade Statistics

Interactive Data Dissemination Service for Trade Statistics - API Enquiry

###Data Request Format: HTTP GET request method
https://tradeidds.censtatd.gov.hk/api/get?lang=<param>&sv=<param,...>&freq=<param>&period=<start,end>&ttype=<param>&tm=<param>&coclass=<param>&co=<param,...>&ccclass=<param>&cc=<param,...>&codeclass=<param>&code=<param,...>
For annual data:
[https://tradeidds.censtatd.gov.hk/api/bb6578c6535a4269b76c5e7034a3b337/get?lang=en&sv=VCy&freq=A&period=2015,2017&ttype=ALL](https://tradeidds.censtatd.gov.hk/api/bb6578c6535a4269b76c5e7034a3b337/get?lang=en&sv=VCy&freq=A&period=2015,2017&ttype=ALL)

For monthly data:
[https://tradeidds.censtatd.gov.hk/api/df5eaaf5f7fb498397408c731c5823e6/get?lang=en&sv=VCm&freq=M&period=201501,201712&ttype=ALL](https://tradeidds.censtatd.gov.hk/api/df5eaaf5f7fb498397408c731c5823e6/get?lang=en&sv=VCm&freq=M&period=201501,201712&ttype=ALL)
###Query string parameters:
- **lang**: Language for the descriptions in the Data Response (JSON). Mandatory. One value only. Valid values are:
- **EN**: English
- **TC**: Traditional Chinese
- **SC**: Simplified Chinese
- **sv**: Statistics. Mandatory. Allow multiple values (e.g. sv=VCm,VCy). Valid values are:
- **VCm**: Value (Monthly)
- **QCm**: Quantity (Monthly)
- **VCy**: Value (Annual/Year-to-date)
- **QCy**: Quantity (Annual/Year-to-date)
- **freq**: Frequency. Mandatory. One value only. Valid values are:
- **A**: Annual
- **M**: Monthly
- **period**: Period. Mandatory. Range of values (e.g. period=2015,2017 queries for Year 2015 to 2017). Valid value formats are:
- **_YYYY,YYYY_**: For Annual, e.g. 2015,2017
- **_YYYYMM,YYYYMM_**: For Monthly, e.g. 201701,201712
- **ttype**: Trade Type. Mandatory. One value only. Valid values are:
- **1**: Imports
- **2**: Domestic exports
- **3**: Re-exports
- **4**: Total exports
- **5**: Total trade
- **ALL**: All
- **tm**: Transport Mode. Optional. One value only. Nil is default or unspecified. Valid value is:
- **Y**: Yes
- **coclass**: Origin class. Optional. One value only. Nil is default or unspecified. Valid values are:
- **R**: Region
- **C**: Country/Territory
- **co**: Origin. Optional. Allow multiple values (e.g. co=CN,US). Nil is default or unspecified.
- Refer to Annex 1 of the [Documentation](https://tradeidds.censtatd.gov.hk/MetadataLink/ApiSpec/API_eng.pdf) for valid values.
- **ccclass**: Consignment class. Optional. One value only. Nil is default or unspecified. Valid values are:
- **R**: Region
- **C**: Country/Territory
- **cc**: Consignment. Optional. Allow multiple values (e.g. cc=CN,US). Nil is default or unspecified.
- Refer to Annex 1 of the [Documentation](https://tradeidds.censtatd.gov.hk/MetadataLink/ApiSpec/API_eng.pdf) for valid values.
- **codeclass**: Commodity Classification. Optional. One value only. Nil is default or unspecified. Valid values are:
- HKHS
- **HKHS2**: 2-digit (division)
- **HKHS4**: 4-digit (heading)
- **HKHS6**: 6-digit (subheading)
- **HKHS8**: 8-digit (code)
- SITC
- **SITC1**: 1-digit (section)
- **SITC2**: 2-digit (division)
- **SITC3**: 3-digit (group)
- **SITC5**: 5-digit (item)
- EUC
- **EUC**: End-Use Category
- **code**: Commodity codes. Optional. Allow multiple values (e.g. code=06,07). Nil is default or unspecified.
- For HKHS and SITC, refer to Annex 2 of the [Documentation](https://tradeidds.censtatd.gov.hk/MetadataLink/ApiSpec/API_eng.pdf) for valid values. Max 20.
- For EUC, no need to specify.
###HTTP Response:
- The response is encoded in UTF-8
- Refer to the [Documentation](https://tradeidds.censtatd.gov.hk/MetadataLink/ApiSpec/API_eng.pdf) for details.

Interactive Data Dissemination Service for Trade Statistics

Interactive Data Dissemination Service for Trade Statistics