Ejemplos de datos de comercio internacional

Particularidades de los datos de comercio internacional

OEC ofrece datos anuales sobre el comercio entre países, desglosados por producto. Estos productos se clasifican usando el Sistema Armonizado (HS), un marco de codificación reconocido globalmente y utilizado por las agencias aduaneras de todo el mundo para categorizar bienes comerciados. Desde su introducción, el HS se ha actualizado varias veces: en 1992, 1996, 2002, 2007, 2012, 2017 y 2022. Correspondiendo a cada versión, la base de datos BACI proporciona datos organizados en conjuntos de datos separados, o "cubos de datos".

Revisión HS	Años	Nombre del cubo
HS92	1995-2023	`trade_i_baci_a_92`
HS96	1996-2023	`trade_i_baci_a_96`
HS02	2002-2023	`trade_i_baci_a_02`
HS07	2007-2023	`trade_i_baci_a_07`
HS12	2012-2023	`trade_i_baci_a_12`
HS17	2017-2023	`trade_i_baci_a_17`
HS22	2022-2023	`trade_i_baci_a_22`

¿Cómo elijo el cubo de datos correcto?

Cada revisión del Sistema Armonizado (HS) ofrece un conjunto consistente de clasificaciones de productos específicas para los años que abarca. Al realizar análisis de comercio a lo largo de varios años, es crucial seleccionar la revisión HS que se alinee con tu rango de tiempo para mantener la coherencia en cómo se definen y categorizan los productos.

Una buena regla general es elegir la revisión HS más reciente que aún se aplique al año más temprano de tu conjunto de datos. Por ejemplo, si estás analizando datos de comercio desde 2010 hasta la actualidad, la clasificación HS 2007 (HS07) sería la más apropiada, ya que garantiza uniformidad en las definiciones de productos durante todo tu período de análisis.

1. Valor total del comercio mundial a lo largo del tiempo

Dado que estamos interesados en el valor total del comercio mundial para la serie temporal más larga posible, deberíamos usar el cubo de la revisión HS92: trade_i_baci_a_92

URL de la API:

https://api-v2.oec.world/tesseract/data.jsonrecords?cube=trade_i_baci_a_92&drilldowns=Year&measures=Trade+Value&limit=100,0

Response:

{
    annotations: {
      table: "HS6 REV. 1992 (1995 - 2023)",
      ...
    },
    page: {...},
    columns: [...],
    data: [
      {
        Year: 1995,
        "Trade Value": 5064428174731,
      },
      {
        Year: 1996,
        "Trade Value": 5366727699264,
      },
      {
        Year: 1997,
        "Trade Value": 5597860603133,
      },
      ... more years ...
      {
        Year: 2023,
        "Trade Value": 22603129713659,
      },
    ],
  };

2. Exportaciones totales de Estonia en los últimos 5 años 🇪🇪

Dado que estamos interesados en las exportaciones totales de Estonia durante los últimos 5 años, debemos usar el cubo de revisión HS17: trade_i_baci_a_17. Para encontrar el ID del País Exportador (en este caso euest para Estonia), podemos usar el endpoint /members para este cubo y establecer Exporter Country como el parámetro level.

URL de la API:

https://api-v2.oec.world/tesseract/data.jsonrecords?cube=trade_i_baci_a_17&drilldowns=Year,Exporter+Country&measures=Trade+Value&include=Year:2019,2020,2021,2022,2023;Exporter+Country:euest&limit=100,0

Respuesta:

{
    annotations: {
      table: "HS6 REV. 2017 (2018 - 2023)",
      ...
    },
    page: {...},
    columns: [...],
    data: [
      {
        "Exporter Country ID": "euest",
        "Exporter Country": "Estonia",
        Year: 2019,
        "Trade Value": 17072197931,
      },
      {
        "Exporter Country ID": "euest",
        "Exporter Country": "Estonia",
        Year: 2020,
        "Trade Value": 16706918778,
      },
      {
        "Exporter Country ID": "euest",
        "Exporter Country": "Estonia",
        Year: 2021,
        "Trade Value": 21847479266,
      },
      {
        "Exporter Country ID": "euest",
        "Exporter Country": "Estonia",
        Year: 2022,
        "Trade Value": 24448580470,
      },
      {
        "Exporter Country ID": "euest",
        "Exporter Country": "Estonia",
        Year: 2023,
        "Trade Value": 20535420466
      }
    ],
  };

3. Exportaciones totales de drones en los 2 años más recientes 🛩️

Dado que estamos interesados en las exportaciones totales de drones en los 2 años más recientes, debemos usar el cubo de revisión HS22, ya que es un producto más nuevo y porque nos interesan los 2 años más recientes: trade_i_baci_a_22. Para encontrar el ID del producto específico que nos interesa (en este caso, la Sección 17 HS6 880629 para drones, es decir, 17880629), podemos usar el endpoint /members para este cubo y establecer HS6 como el parámetro level.

URL de la API:

https://api-v2.oec.world/tesseract/data.jsonrecords?cube=trade_i_baci_a_22&drilldowns=Year,HS6&measures=Trade+Value&include=Year:2022,2023;HS6:17880629&limit=100,0

Respuesta:

{
    annotations: {
      table: "HS6 REV. 2022 (2022 - 2023)",
      ...
    },
    page: {...},
    columns: [...],
    data: [
      {
        "HS6 Code": "17880629",
        "HS6 Description": "Heavy drones (>150kg), RC Only",
        Year: 2022,
        "Trade Value": 110048559,
      },
      {
        "HS6 Code": "17880629",
        "HS6 Description": "Heavy drones (>150kg), RC Only",
        Year: 2023,
        "Trade Value": 341776768,
      },
    ],
  };

4. Productos importados por Canadá en el año más reciente 🇨🇦

En este ejemplo, analizaremos las importaciones totales de Canadá desglosadas por categorías de productos en el año más reciente. Usaremos la revisión HS22 ya que estamos interesados en datos recientes, y utilizaremos el nivel HS2 para categorías de productos amplias. El código de país para Canadá es nacan.

Nota: Para filtrar por el año más reciente, en lugar de especificar el año en el parámetro include, podemos usar el parámetro time con la palabra clave latest.

URL de la API:

https://api-v2.oec.world/tesseract/data.jsonrecords?cube=trade_i_baci_a_22&drilldowns=Year,HS2,Importer+Country&measures=Trade+Value&include=Importer+Country:nacan&time=Year.latest&sort=-Trade+Value&limit=100,0

Respuesta:

{
    annotations: {
      table: "HS6 REV. 2022 (2022 - 2023)",
      ...
    },
    page: {...},
    columns: [...],
    data: [
      {
        "HS2 Code": "1787",
        "HS2 Description": "Vehicles other than railway",
        "Importer Country": "Canada",
        "Importer Country ID": "nacan",
        Year: 2023,
        "Trade Value": 115678234567
      },
      {
        "HS2 Code": "1784",
        "HS2 Description": "Machinery and computers",
        "Importer Country": "Canada",
        "Importer Country ID": "nacan",
        Year: 2023,
        "Trade Value": 98234567890
      },
      ... more products ...
      {
        "HS2 Code": "1739",
        "HS2 Description": "Plastics and articles thereof",
        "Importer Country": "Canada",
        "Importer Country ID": "nacan",
        Year: 2023,
        "Trade Value": 32109876543
      }
    ],
  };

5. Importaciones totales de automóviles a Canadá desde Alemania en el año más reciente 🇨🇦 🚗 🇩🇪

En este siguiente ejemplo, vamos a utilizar los datos completos de comercio bilateral. Dado que estamos interesados en las importaciones totales de automóviles a Canadá desde Alemania en el año más reciente, debemos usar la revisión más reciente (HS22) y, dado que nos interesan los automóviles, que es una categoría de producto agregada, debemos usar el nivel de 4 dígitos (HS4). Para encontrar el ID del producto específico que nos interesa (en este caso, 178703 para automóviles), podemos usar el endpoint /members para este cubo e incluir HS4 como el parámetro level.

URL de la API:

https://api-v2.oec.world/tesseract/data.jsonrecords?cube=trade_i_baci_a_22&drilldowns=Year,Importer+Country,Exporter+Country&measures=Trade+Value&include=Importer+Country:nacan;Exporter+Country:eudeu&time=Year.latest&limit=100,0

Respuesta:

{
    annotations: {
      table: "HS6 REV. 2022 (2022 - 2023)",
      ...
    },
    page: {...},
    columns: [...],
    data: [
      {
        "Importer Country ID": "nacan",
        "Importer Country": "Canada",
        "Exporter Country ID": "eudeu",
        "Exporter Country": "Germany",
        Year: 2023,
        "Trade Value": 14431175781,
      },
    ],
  };

Introducción