Reference your datasets on

Carole Bodilis Updated by Carole Bodilis

This article was written for producers of French open data who publish it on the Opendatasoft platform, but who wish to also have their data referenced on to increase its discoverability.

The method defined jointly by the Etalab and Opendatasoft teams is based on the Opendatasoft DCAT export and the DCAT harvester.

The steps involved are as follows:

  1. Fill in the metadata for each dataset
  2. Copy the DCAT export link, having selected datasets for publication
  3. Set up the harvester in your organization's profile on
- An Opendatasoft portal configured to allow anonymous users
- An "Organisation" profile on

Step 1: Fill in the metadata

Metadata to fill in

In Opendatasoft, the metadata you need to fill in for your datasets—and which are used to calculate the quality score on—are listed below:

ODS metadata template

ODS metadata field

Matching metadata field

How to fill it out







For a public administration, these licenses are recommended: Licence Ouverte version 2.0 or ODC Open Database License (ODbL) version 1.0. For more information, see here (in French).


Accrual periodicity


One of the following values:

  • Triennal
  • Biennal
  • Annuelle
  • Deux fois par an
  • Trois fois par an
  • Trimestrielle
  • Bimestrielle
  • Mensuelle
  • Deux fois par mois
  • Toutes les deux semaines
  • Trois fois par mois
  • Hebdomadaire
  • Deux fois par semaine
  • Trois fois par semaine
  • Quotidienne
  • Continue
  • Sans régularité


Temporal coverage start date + Temporal coverage end date

Couverture temporelle

Fill out the start and end dates for the data.



Couverture territoriale

This metadata is not currently retrieved by, so needs to be added individuqlly to each dataset on the side.

Option 1: Reference all of the datasets on your portal

Go to your portal's catalog (<the URL of your portal>/explore).

Find the "RDF/XML (DCAT)" export link at the bottom left of your screen.

Right-click on the link to copy it. This is what you will use when setting up the harvester on

Option 2: Reference a subset of your data

This option is preferable if you don't want to reference all of your portal's datasets. For example, you may wish to exclude the SIRENE database or other data published by third-party organizations. This step can be quite technical, so don't hesitate to contact Opendatasoft support if you need assistance.

In this case, you'll need to create the export URL with:

  • The root <the URL of your portal>/api/v2/catalog/exports/dcat
  • Plus the parameters to filter the export, based on ODSQL syntax (Opendatasoft API query language)

The resulting link is what you will use when setting up the harvester on

  1. Here's an example of a query to retrieve the DCAT export from the portal, excluding the "Opendatasoft" producer:!="Opendatasoft"
  2. Here's an example query to retrieve the DCAT export from the portal, excluding the "Opendatasoft" producer and filtering on the "Population" keyword:!="Opendatasoft" AND keyword="Population"&lang=en
Note that you can run the test with a CSV export to see if you are indeed retrieving the desired datasets:!="Opendatasoft"

Create the harvester on

For this final step, follow the documentation at (in French).

Remember to select the DCAT harvesting option.

Once done, what will be available on

  • The metadata for the datasets you've referenced.
  • Export files for the datasets you've referenced. For all datasets, CSV, XLSX, and JSON exports will be available as resources on If the dataset contains geographic forms, the GeoJSON export will also be available.
  • Other resources. If you wish to add other files to be available as resources on, you can add them to your dataset's alternative exports (as a file, or via URL).

How did we do?

Referencing your datasets with your national open data portal (DCAT-AP)


Powered by HelpDocs (opens in a new tab)