所有 API

商品進口 API

十個國家的官方貨物進口總額。

首次請求

快速入門
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/trade/imports?period=2026-06" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
回應範例 示例回應 · 並非實時請求
{
  "country": "USA",
  "period": "2026-06",
  "flow": "import",
  "value": "275000000000",
  "currency": "USD",
  "coverage": "merchandise",
  "partner": null,
  "product": null,
  "released_on": "2026-08-04"
}

端點

GET商品進口/v1/economics/{country}/trade/imports
country
支援的一個大寫國家代碼:AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布,或傳入一個精確期間。
partner
根據合約已接受,但當前測試版不會發布篩選後的合作夥伴總數。
product
HS 商品代碼。請將其與分類一並提供。
classification
《協調制度》的版本。請與product一同提供。

MCP · economics_get_trade_imports

API 參考
GET商品進口歷史數據/v1/economics/{country}/trade/imports/observations
country
支援的一個大寫國家代碼:AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
start
包含的首個觀測期。
end
包含的最後觀測期。
limit
最多返回的觀測值數量。預設為 100。
cursor
上一頁返回的next_cursor。

MCP · economics_get_trade_imports_history

API 參考

歷史

cURL
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/trade/imports/observations?start=2026-06&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
回應範例 示例回應 · 並非實時請求
{
  "observations": [
    {
      "country": "USA",
      "measure": "trade_imports",
      "value": "275000000000",
      "unit": "USD",
      "transformation": "",
      "period": "2026-06"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}

來源與方法論

明確的期間

省略此參數可獲取最新已接受的完整發布,或傳入一個精確期間。

REST 和 MCP

使用一個 API 金鑰,透過 REST 或 MCP 取得最新及歷史資料。

常見問題

回應包含哪些內容?

獲取一個國家某個期間的商品進口總額。

可以請求哪些期間?

YYYY 或 YYYY-MM

支援哪些資料範圍?

AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP和USA的未篩選全國商品進口總額已公開。契約接受夥伴和產品篩選條件,但在篩選總額發布前會返回404。

發起你的第一個請求

獲取免費 API 密鑰