Catalog / CEPII (Centre d'Études Prospectives et d'Informations Internationales) — Gravity database

cepii_gravity

CEPII (Centre d'Études Prospectives et d'Informations Internationales) — Gravity database

Name: CEPII (Centre d'Études Prospectives et d'Informations Internationales) — Gravity database
Creator: CEPII
License: https://www.etalab.gouv.fr/licence-ouverte-open-licence

Open · redistributedEtalab Open Licence 2.0International Trade

Redistributable. This source is served as canonical Parquet under the license below, with attribution and provenance preserved.

Coverage

Series catalogued

1,143,250

Licensing & provenance

License: Etalab Open Licence 2.0
License URL: https://www.etalab.gouv.fr/licence-ouverte-open-licence
Required attribution: Source: CEPII, Gravity database, licensed under the Etalab Open Licence 2.0
Redistribution: Permitted (served here)
Commercial use: Yes
Modification: Permitted
Provider homepage: https://www.cepii.fr/cepii/en/bdd_modele/bdd_modele_item.asp?id=8
Provider terms: https://www.cepii.fr/cepii/en/bdd_modele/bdd_modele_item.asp?id=8

Access & mirrors

Download: Select & download cepii_gravity series as CSV →
API: Get a free API key, then GET /v1/series/<id>.csv
Canonical landing: https://econdatalibrary.com/cepii_gravity
Update cadence: static
Automated refresh: live — this database is on the daily update run
Update strategy: bulk snapshot if changed
Storage layout: single-file — data/clean_full/cepii_gravity/cepii_gravity.parquet (one pa.table written once). Download is buffered fully in memory (500MB cap), not cached to data/raw.

Full description

CEPII Gravity Dataset ingest. Source: http://www.cepii.fr/CEPII/en/bdd_modele/presentation.asp?id=8 Authors: Head & Mayer (CEPII) License: Free for research use Coverage: All country pairs, 1948-2019, bilateral trade gravity variables Key variables: dist (distance), comlang_off (common language), colony, contig (contiguity), gdp_o, gdp_d (origin/dest GDP), pop_o, pop_d, tradeflow_comtrade_o/d (trade) fta_wto, gatt_o, gatt_d, wto_o, wto_d (trade agreements) lang_ethno, col_dep, col_dep_ever, etc. Gravity data is bilateral (country pairs), so series_key includes both countries. series_key: GRAVITY:{variable}:{iso3_o}:{iso3_d} e.g. GRAVITY:dist:USA:CHN Note: The full gravity dataset is large (1.4GB CSV). We fetch a compressed version or summary statistics to keep file size manageable. Output: data/clean_full/cepii_gravity/cepii_gravity.parquet Run: python jobs/ingest_cepii_gravity.py

Structured metadata

schema.org/Dataset (Google Dataset Search)

{
  "@context": "https://schema.org/",
  "@type": "Dataset",
  "name": "CEPII (Centre d'Études Prospectives et d'Informations Internationales) — Gravity database",
  "description": "Gravity-model variables for every country pair. CEPII. 1,143,250 series. Free download.",
  "url": "https://econdatalibrary.com/cepii_gravity",
  "identifier": "cepii_gravity",
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "includedInDataCatalog": {
    "@type": "DataCatalog",
    "@id": "https://econdatalibrary.com/#catalog",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com/catalog"
  },
  "creator": {
    "@type": "Organization",
    "name": "CEPII",
    "url": "https://www.cepii.fr/cepii/en/bdd_modele/bdd_modele_item.asp?id=8"
  },
  "license": "https://www.etalab.gouv.fr/licence-ouverte-open-licence",
  "keywords": [
    "International Trade",
    "cepii_gravity"
  ],
  "dateModified": "2024-04-15",
  "creditText": "Source: CEPII, Gravity database, licensed under the Etalab Open Licence 2.0",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-cepii_gravity",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "distribution": [
    {
      "@type": "DataDownload",
      "name": "cepii_gravity — CSV",
      "encodingFormat": "text/csv",
      "contentUrl": "https://econdatalibrary.com/download.html?source=cepii_gravity",
      "license": "https://www.etalab.gouv.fr/licence-ouverte-open-licence"
    }
  ]
}

Croissant (ML-ready, schema.org JSON-LD)

{
  "@context": {
    "@language": "en",
    "@vocab": "https://schema.org/",
    "cr": "http://mlcommons.org/croissant/",
    "data": {
      "@id": "cr:data",
      "@type": "@json"
    },
    "dataType": {
      "@id": "cr:dataType",
      "@type": "@vocab"
    },
    "sc": "https://schema.org/",
    "conformsTo": "dct:conformsTo",
    "dct": "http://purl.org/dc/terms/"
  },
  "@type": "sc:Dataset",
  "conformsTo": "http://mlcommons.org/croissant/1.0",
  "name": "cepii_gravity",
  "description": "Gravity-model variables for every country pair. CEPII. 1,143,250 series. Free download.",
  "url": "https://econdatalibrary.com/cepii_gravity",
  "creator": {
    "@type": "sc:Organization",
    "name": "CEPII",
    "url": "https://www.cepii.fr/cepii/en/bdd_modele/bdd_modele_item.asp?id=8"
  },
  "publisher": {
    "@type": "sc:Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "license": "https://www.etalab.gouv.fr/licence-ouverte-open-licence",
  "keywords": [
    "International Trade"
  ],
  "distribution": [
    {
      "@type": "cr:FileObject",
      "@id": "cepii_gravity-csv",
      "name": "cepii_gravity-csv",
      "description": "Per-series CSV, downloadable with a free API key.",
      "contentUrl": "https://econdatalibrary.com/download.html?source=cepii_gravity",
      "encodingFormat": "text/csv"
    }
  ]
}

Part of the Econ Data Library catalog · metadata generated 2026-08-02 from the central registry · browse all datasets