貿易カバレッジルートAPIリファレンス
各国の貿易ルートにどのソースが回答するか、何を保有しているか、何月から何月までかを読み取ります。
概要
GET /
GET / は、国ごとに1行を返します。パートナー国ルートと品目ルートに誰が回答するか、現在回答するソース、保有するすべてのソース、保有する月です。貿易の対象国ページが一般的に答える問いに対する、最新の回答です。
国の上に何かを構築する前に呼び出してください。answers_ は、basis のないリクエストが現在回答されるソースで、tiers_ は行を持つ basis のすべての値を挙げます。1行だけを得るには country を送り、すべての国を得るには省略します。この呼び出しは無料です。MCPツールは trade_ で、同じパラメータを受け付けます。
リクエスト
英国のカバレッジと、実際のレスポンス:
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_ は own)、品目を保有しています(products_ は own)。first_ と latest_ は、その機関から保有している月です。
パラメータ
| パラメータ | 場所 | 種別 | 必須 | デフォルト | 許容値と意味 |
|---|---|---|---|---|---|
country | クエリ | 文字列 | いいえ | すべての国 | ISO 3166-1 alpha-3コード1つ(大文字)、またはユーロ圏を表す EMU。省略すると、回答には国ごとに1行が含まれます。国ではないコードには400が返り、行のない国には404が返ります。 |
レスポンス
回答にはフィールドが1つ、countries(一覧)だけあります。各項目には次のフィールドがあります。
| フィールド | 意味 |
|---|---|
country | 国、またはユーロ圏を表す EMU。 |
partners_ | Narwhalが直接保有しているものから、パートナー国ルートに誰が回答するか:その国自身の税関または統計機関である own、またはNarwhalがその国自身の機関の数値を保有していない場合は、方向を入れ替えた他国の報告である partner_。 |
partner_ | すべてのパートナー国が掲載される場合は all、公表元が上位のパートナー国と残りの1行のみを表示する場合は top_。partners_ が partner_ の場合は null。 |
products_ | 品目ルートに誰が回答するか:own、またはその国に独自の品目ファイルがない場合は partner_。UN Comtradeはパートナー国の合計のみを保有するため、品目別には回答しません。 |
answers_ | パートナー国ルートと品目ルートが現在回答するソース。順序は、その国自身の機関(own)、そのUN Comtradeへの申告(third_)、他国の報告(partner_、公式の数値ではありません)。他国の報告がUN Comtradeより先になるのは、その国について200以上の報告国が行を持つ場合に限られますが、これはNarwhalが保有する数を上回るため、最後になります。類別では、UN Comtradeは何も保有していないため、partner_ が回答します。Narwhalがその国について何も保有していない間は null。 |
tiers_ | 現在行を持つすべてのソース:この国に回答する basis の値。 |
first_ | Narwhalがその国自身の機関から保有する最初の月。ない場合は null。 |
latest_ | Narwhalがその国自身の機関から保有する最新の月。ない場合は null。 |
comtrade_ | その国がUN Comtradeに申告した最新の月。ない場合は null。 |
third_ | NarwhalがUN Comtradeからその国について保有する最新の月。ない場合は null。 |
comtrade_ | その国がUN Comtradeに申告した月数。 |
comtrade_ | その国がUN Comtradeに申告した最新の年。 |
has_ | その国が財貿易の月次の総額見出しを公表している場合は true。 |
has_ | その国がサービス貿易を公表している場合は true。 |
has_ | 国別の関税率表が利用できる場合は 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_ は own、products_ は partner_ です。カナダのパートナー国はカナダ統計局(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_ を含む共通のエラー形式で返されます。キーがない、または無効な場合(401)、残高が呼び出しの料金に満たない場合(402)、1分あたりのリクエストが多すぎる場合(429)は、すべてのルートに共通するアカウントのエラーです。APIエラーとクレジットを参照してください。
| ステータス | コード | 発生する場面 |
|---|---|---|
400 | invalid_query | country が国コードではない場合。 |
404 | country_not_covered | Narwhalは、どのソースにもその国の貿易の行を保有していません。 |
このページは役に立ちましたか?