快速示例

  1. 文档
  2. CEIC宏观经济数据API
  3. API 文档
  4. 快速示例

注：请注意，为了测试示例中的API调用，需要在API调用中将令牌添加到“token=”后。

搜索宏观经济数据

用例: 您对法国、爱尔兰和波兰的主要国际收支差额数据很感兴趣。要从CEIC数据库中以JSON格式检索此类宏观经济数据，请使用 series/search 功能。:

API调用:
https://api.ceicdata.com/v2//series/search?format=json&database=GLOBAL&country=PL%2C%20IE%2C%20FR&key_only=true&keyword=Balance%20of%20Payment&token=
Test_Example Interactive_Doc Use_Params

image

获取宏观经济数据集的详细信息

用例: 您对约旦的每日存款额度很感兴趣。要检索相关数列的详细信息，需要执行以下步骤:

  1. 使用 series/search 功能获取CEIC数列ID列表。
    API调用:
    https://api.ceicdata.com/v2//series/search?format=json&country=JO&keyword=deposit&status=T&frequency=D&name_only=true&token=
    Test_Example Interactive_Doc Use_Params
    image
  2. 使用 series/{id} 功能，按从上一步提取的CSV格式的数列ID列出各个系列的详细信息。
    API Call:
    https://api.ceicdata.com/v2//series/130717708,349664002,349664102,349664302?format=csv&token=
    Test_Example Interactive_Doc Use_Params
    image

获取最新宏观经济数据集

用例: 您对2019年4月1日后更新的约旦的每日存款数据很感兴趣，其中包括该期间之后的新数据和修正数据。要检索JSON格式的最新更新信息，请使用 series/{id}/data 功能。

API调用:
https://api.ceicdata.com/v2//series/130717708,349664002,349664102,349664302/data?format=json&updated_after=2019-04-01&time_points_status=active&token=
Test_Example Interactive_Doc Use_Params

image

从CEIC CDMNext平台获取预定义的数据模板

用例: 您已经是CEIC订阅用户，可以访问我们的CDMNext平台。您已经保存了数据模板文档，其中包含用户使用的数据或用户对我们团队创建的数据模板感兴趣的数据。要使用API下载模板数据，请执行以下步骤:

  1. 使用 insights / search 功能在“My Insight”下列出所有数据模板。
    API调用:
    https://api.ceicdata.com/v2//insights/search?group=my&token=
    Test_Example Interactive_Doc Use_Params
    image
  2. 使用从上一个步中提取的数据模板ID和 insights/{id} 功能获取模板数据。
    API调用:
    https://api.ceicdata.com/v2//insights/c1554e8c-667f-4432-b501-009906473868?format=json&token=
    Test_Example Interactive_Doc Use_Params
    image
  3. 使用 insights/{id}/download/{file_format} 功能下载PDF或XLSX格式的数据模板。
    API调用:
    https://api.ceicdata.com/v2//insights/ea79e081-66eb-4fbc-9a1f-4baf404e3525/download/pdf?token=
    Test_Example Interactive_Doc Use_Params
    image

获取用户处理的数据

用例: 您希望下载带有应用转换的CEIC数据。到目前为止，唯一可用的选项是应用CDMNext数据模板中的数据处理并使用API下载数据。要下载用户处理的数据，请执行以下步骤:

  1. 在已保存的名为“MyTestAPI”的数据模板中，对数列384165717应用“Aggregate (Yearly, Sum)”，对数列11321901应用“Aggregate (Monthly, Avg))”。
  2. 使用 insights/search 下列出所有数据模板，从中查找“MyTestAPI”模板。
    API调用:
    https://api.ceicdata.com/v2//insights/search?group=my&token=
    Test_Example Interactive_Doc Use_Params
    image
  3. 使用 insights/{id}/series/data 功能，从“MyTestAPI”数据模板中获取处理后的数据。
    API调用:
    https://api.ceicdata.com/v2//insights/c1554e8c-667f-4432-b501-009906473868/series/data?token=
    Test_Example Interactive_Doc Use_Params
    image

构建CEIC布局树

用例: 期望在本地系统构建CEIC布局树。要构建布局树，请执行以下步骤:

  1. 使用 layout/database 功能列出所有CEIC数据库。
    API调用:
    https://api.ceicdata.com/v2//layout/databases?token=
    Test_Example Interactive_Doc .
  2. Step_List_DB_Topic layout/database/{id}/topics 功能列出所选数据库下的主题（例如：Global）。
    API调用:
    https://api.ceicdata.com/v2//layout/databases/GLOBAL/topics?token=
    Test_Example Interactive_Doc Use_Params
    image
  3. 使用 layout/topics/{id}/sections 功能列出选定主题下的板块（例如：Albania）。
    API调用:
    https://api.ceicdata.com/v2//layout/topics/TP40775/sections?token=
    Test_Example Interactive_Doc Use_Params
    image
  4. 使用 layout/sections/{id}/tables 功能在选定板块下列出表（例如：Production）。
    API调用:
    https://api.ceicdata.com/v2//layout/sections/SC40788/tables?token=
    Test_Example Interactive_Doc Use_Params
    image
  5. 使用 layout/tables/{id}/series 功能在所选表下列出数列（例如：Table: AL.B002: Production Volume Index: 2005=100：2005=100)。
    API调用:
    https://api.ceicdata.com/v2//layout/tables/TB159222/series?token=
    Test_Example Interactive_Doc Use_Params
    image

创建用户定义的筛选器

用例: 用户希望跨CEIC数据创建自己特有的筛选器，该筛选器可以多次用于搜索和检索数据。用户希望检索JSON格式的保加利亚国家“GDP”月度关键数列数据。若要构建筛选器，请使用 /filters 功能。:

API调用:
https://api.ceicdata.com/v2//filters?format=json&token=
Test_Example Interactive_Doc Use_Params

image