すべてのドキュメントを閲覧

貿易カバレッジルートAPIリファレンス

各国の貿易ルートにどのソースが回答するか、何を保有しているか、何月から何月までかを読み取ります。

概要

GET /v1/trade/coverage

GET /v1/trade/coverage は、国ごとに1行を返します。パートナー国ルートと品目ルートに誰が回答するか、現在回答するソース、保有するすべてのソース、保有する月です。貿易の対象国ページが一般的に答える問いに対する、最新の回答です。

国の上に何かを構築する前に呼び出してください。answers_with は、basis のないリクエストが現在回答されるソースで、tiers_held は行を持つ basis のすべての値を挙げます。1行だけを得るには country を送り、すべての国を得るには省略します。この呼び出しは無料です。MCPツールは trade_get_coverage で、同じパラメータを受け付けます。

リクエスト

英国のカバレッジと、実際のレスポンス:

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/trade/coverage?country=GBR"
英国
{
  "countries": [
    {
      "country": "GBR",
      "partners_tier": "own",
      "partner_coverage": "all",
      "products_tier": "own",
      "answers_with": "own",
      "tiers_held": [
        "own",
        "partner_reported"
      ],
      "first_period": "2010-01",
      "latest_period": "2026-09",
      "comtrade_latest_period": "2026-08",
      "third_party_latest_period": null,
      "comtrade_periods": 200,
      "comtrade_latest_year": 2025,
      "has_headline": true,
      "has_services": true,
      "has_tariff_book": true
    }
  ]
}

英国自身の機関が回答し(answers_with は own)、品目を保有しています(products_tier は own)。first_period と latest_period は、その機関から保有している月です。

パラメータ

パラメータ場所種別必須デフォルト許容値と意味
countryクエリ文字列いいえすべての国ISO 3166-1 alpha-3コード1つ(大文字)、またはユーロ圏を表す EMU。省略すると、回答には国ごとに1行が含まれます。国ではないコードには400が返り、行のない国には404が返ります。

レスポンス

回答にはフィールドが1つ、countries(一覧)だけあります。各項目には次のフィールドがあります。

フィールド意味
country国、またはユーロ圏を表す EMU。
partners_tierNarwhalが直接保有しているものから、パートナー国ルートに誰が回答するか:その国自身の税関または統計機関である own、またはNarwhalがその国自身の機関の数値を保有していない場合は、方向を入れ替えた他国の報告である partner_reported。
partner_coverageすべてのパートナー国が掲載される場合は all、公表元が上位のパートナー国と残りの1行のみを表示する場合は top_n。partners_tier が partner_reported の場合は null。
products_tier品目ルートに誰が回答するか:own、またはその国に独自の品目ファイルがない場合は partner_reported。UN Comtradeはパートナー国の合計のみを保有するため、品目別には回答しません。
answers_withパートナー国ルートと品目ルートが現在回答するソース。順序は、その国自身の機関(own)、そのUN Comtradeへの申告(third_party)、他国の報告(partner_reported、公式の数値ではありません)。他国の報告がUN Comtradeより先になるのは、その国について200以上の報告国が行を持つ場合に限られますが、これはNarwhalが保有する数を上回るため、最後になります。類別では、UN Comtradeは何も保有していないため、partner_reported が回答します。Narwhalがその国について何も保有していない間は null。
tiers_held現在行を持つすべてのソース:この国に回答する basis の値。
first_periodNarwhalがその国自身の機関から保有する最初の月。ない場合は null。
latest_periodNarwhalがその国自身の機関から保有する最新の月。ない場合は null。
comtrade_latest_periodその国がUN Comtradeに申告した最新の月。ない場合は null。
third_party_latest_periodNarwhalがUN Comtradeからその国について保有する最新の月。ない場合は null。
comtrade_periodsその国がUN Comtradeに申告した月数。
comtrade_latest_yearその国がUN Comtradeに申告した最新の年。
has_headlineその国が財貿易の月次の総額見出しを公表している場合は true。
has_servicesその国がサービス貿易を公表している場合は true。
has_tariff_book国別の関税率表が利用できる場合は true。

その他の例

その国自身の機関がパートナー国の合計のみを提供する国

カナダ。その国自身の機関はパートナー国の合計のみを提供します:

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/trade/coverage?country=CAN"
カナダ
{
  "countries": [
    {
      "country": "CAN",
      "partners_tier": "own",
      "partner_coverage": "top_n",
      "products_tier": "partner_reported",
      "answers_with": "own",
      "tiers_held": [
        "own",
        "partner_reported"
      ],
      "first_period": "2010-01",
      "latest_period": "2026-09",
      "comtrade_latest_period": "2026-08",
      "third_party_latest_period": null,
      "comtrade_periods": 200,
      "comtrade_latest_year": 2025,
      "has_headline": true,
      "has_services": true,
      "has_tariff_book": true
    }
  ]
}

partners_tier は own、products_tier は partner_reported です。カナダのパートナー国はカナダ統計局(Statistics Canada)から、類別の品目は他国の報告から取得されます。

対象外の国

実在する国コードで数値がない場合、404が返り、無料です:

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/trade/coverage?country=ATA"
南極
{
  "type": "https://narwhalapi.com/problems/country-not-covered",
  "title": "Country not covered",
  "status": 404,
  "detail": "ATA is not in the trade coverage list.",
  "code": "country_not_covered",
  "request_id": "c16523b6-7d27-4e1b-a2c3-f7e2acead523"
}

ソース

このルートはソースを報告します。ソースを選ぶことはしません。各ソースが何であり、いつ回答するかについては、貿易の対象国ページを参照してください。

通貨

このルートは値を返さないため、通貨は適用されません。

ページング

このルートにはページングがありません。country のないリクエストは、すべての国を1回の回答で返します。

価格

このルートは無料です。呼び出しには課金されず、アカウントにはキーが必要です。

エラー

これらのエラーは、request_id を含む共通のエラー形式で返されます。キーがない、または無効な場合(401)、残高が呼び出しの料金に満たない場合(402)、1分あたりのリクエストが多すぎる場合(429)は、すべてのルートに共通するアカウントのエラーです。APIエラーとクレジットを参照してください。

ステータスコード発生する場面
400invalid_querycountry が国コードではない場合。
404country_not_coveredNarwhalは、どのソースにもその国の貿易の行を保有していません。

APIエラーとクレジット · 貿易データAPIリファレンス · 貿易の対象国

このページは役に立ちましたか?