Target Market

Retrieve available target markets for the selected country, HS code, period, and trade flow.

ENDPOINTS

POST /api/v1/tradeAnalytics/marketList

Request parameters

countryCode

string

Country ISO3 code

Required: Yes
Example: USA

startDate

string

Start period in YYYY-MM format

Required: Yes
Example: 2024-01

endDate

string

End period in YYYY-MM format

Required: Yes
Example: 2024-12

hsCode

string

HS code

Required: No
Example: 28

ie

string

Trade flow. Use i for import and e for export.

Required: No
Example: e

Request Example

{
    "countryCode": "USA",
    "startDate": "2024-01",
    "endDate": "2024-12",
    "hsCode": "28",
    "ie": "e"
}

curl https://api.tradedata.io/api/v1/tradeAnalytics/marketList \
  -H "Authorization: Bearer yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "USA", "startDate": "2024-01", "endDate": "2024-12", "hsCode": "28", "ie": "e"}'

import requests

response = requests.post(
    "https://api.tradedata.io/api/v1/tradeAnalytics/marketList",
    headers={
        "Authorization": "Bearer yourTokenHere",
        "Content-Type": "application/json",
    },
    json={
        "countryCode": "USA",
        "startDate": "2024-01",
        "endDate": "2024-12",
        "hsCode": "28",
        "ie": "e",
    },
)
print(response.json())

const response = await fetch("https://api.tradedata.io/api/v1/tradeAnalytics/marketList", {
  method: "POST",
  headers: {
    "Authorization": "Bearer yourTokenHere",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "countryCode": "USA",
    "startDate": "2024-01",
    "endDate": "2024-12",
    "hsCode": "28",
    "ie": "e"
  }),
});
const data = await response.json();

<?php
$ch = curl_init("https://api.tradedata.io/api/v1/tradeAnalytics/marketList");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer yourTokenHere",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "countryCode" => "USA",
        "startDate" => "2024-01",
        "endDate" => "2024-12",
        "hsCode" => "28",
        "ie" => "e"
    ]),
]);
echo curl_exec($ch);

Response parameters

code

int

Status code

Example: 200

data

array

Result container

data.continent

string

Continent name

Example: NORTH AMERICA

data.continentCn

string

Continent name (Chinese)

Example: 北美洲

data.continentCode

string

Continent code

Example: NA

data.countrys

array

List of countries under the continent

Example: -

data.countrys.country

string

Country name (Chinese)

Example: 美国

data.countrys.country_En

string

Country name (English)

Example: United States of America (the)

data.countrys.threeEnCountryCode

string

Country ISO3 code

Example: USA

data.countrys.ie

string

Trade flow. Use i for import and e for export.

Example: I

data.countrys.countryStd

string

Standard country name

Example: UNITED STATES

Response Example

{
    "code": 200,
    "success": true,
    "data": [
        {
            "continent": "NORTH AMERICA",
            "continentCn": "北美洲",
            "continentCode": "NA",
            "countrys": [
                {
                    "country": "美国",
                    "country_En": "United States of America (the)",
                    "threeEnCountryCode": "USA",
                    "ie": "I",
                    "countryStd": "UNITED STATES"
                }
            ]
        },
        {
            "continent": "ASIA",
            "continentCn": "亚洲",
            "continentCode": "AS",
            "countrys": [
                {
                    "country": "印度",
                    "country_En": "India",
                    "threeEnCountryCode": "IND",
                    "ie": "I",
                    "countryStd": "INDIA"
                },
                {
                    "country": "中国",
                    "country_En": "China",
                    "threeEnCountryCode": "CHN",
                    "ie": "I",
                    "countryStd": "CHINA"
                },
                {
                    "country": "日本",
                    "country_En": "Japan",
                    "threeEnCountryCode": "JPN",
                    "ie": "I",
                    "countryStd": "JAPAN"
                },
                {
                    "country": "中国台湾",
                    "country_En": "Taiwan (Province of China)",
                    "threeEnCountryCode": "TWN",
                    "ie": "I",
                    "countryStd": "CHINA TAIWAN"
                }
            ]
        },
        {
            "continent": "EUROPE",
            "continentCn": "欧洲",
            "continentCode": "EU",
            "countrys": [
                {
                    "country": "英国",
                    "country_En": "United Kingdom of Great Britain and Northern Ireland (the)",
                    "threeEnCountryCode": "GBR",
                    "ie": "I",
                    "countryStd": "UNITED KINGDOM"
                },
                {
                    "country": "意大利",
                    "country_En": "Italy",
                    "threeEnCountryCode": "ITA",
                    "ie": "I",
                    "countryStd": "ITALY"
                },
                {
                    "country": "法国",
                    "country_En": "France",
                    "threeEnCountryCode": "FRA",
                    "ie": "I",
                    "countryStd": "FRANCE"
                },
                {
                    "country": "德国",
                    "country_En": "Germany",
                    "threeEnCountryCode": "DEU",
                    "ie": "I",
                    "countryStd": "GERMANY"
                },
                {
                    "country": "荷兰",
                    "country_En": "Netherlands (the)",
                    "threeEnCountryCode": "NLD",
                    "ie": "I",
                    "countryStd": "NETHERLANDS"
                }
            ]
        }
    ],
    "msg": "success",
    "total": 0,
    "pageSize": 0,
    "current": 0,
    "sumResult": null
}