datasets | Guides de data.gouv.fr ⌘Ctrlk ✉️ Contact💬 Forum Plus Documentation de data.gouv.fr Guides sur les données Documentation de l’Annuaire des Entreprises Documentation ecologie.data.gouv.fr Fabrique des strandards Passe marché Accueil ❓Foire aux questions COMPTE UTILISATEUR Créer un compte utilisateur Suivre vos contenus publiés ORGANISATIONS Rejoindre une organisation Créer une organisation Modifier son organisation Gérer les membres de son organisation Suivre l'activité de son organisation Obtenir une certification JEUX DE DONNÉES Publier un jeu de données Ressource communautaire Modifier un jeu de données API Publier une API Modifier une API RÉUTILISATIONS Publier une réutilisation Modifier une réutilisation API DE DATA.GOUV.FR Prise en main Référencesite datasets reuses discussions organizations spatial users me contacts workers tags topics posts transfer notifications avatars harvest dataservices Télécharger le catalogue de données de data.gouv.fr Accéder au catalogue via SPARQL MOISSONNAGE Comprendre le moissonnage Mettre en place un moissonneur INTELLIGENCE ARTIFICIELLE Notre approche de l’intelligence artificielle sur data.gouv.fr Le serveur MCP de data.gouv.fr Le skill data.gouv.fr Données spécifiques Publier une Base Adresse Locale Données de forte valeur : métadonnées obligatoires et modalités de rapportage Données de la commande publique Données de transports et mobilités Autres Créer une verticale thématique de data.gouv.fr Propulsé par GitBook Sur cette page For the complete documentation index, see llms.txt. This page is also available as Markdown. Copier Sur cette page Documentation de data.gouv.fr API DE DATA.GOUV.FR Référence datasets Dataset related operations List or search all datasets gethttp://www.data.gouv.fr/api/1/datasets/ Paramètres de requête qstringOptionnelThe search query sortstring · enumOptionnelThe field (and direction) on which sorting apply Valeurs possibles: titlecreatedlast_updatereusesfollowersviews-title-created-last_update-reuses-followers-views pageintegerOptionnelThe page to fetch page_sizeintegerOptionnelThe page size to fetch tagstring[]Optionnel licensestringOptionnel featuredbooleanOptionnelIf set to true, it will filter on featured datasets only. If set to false, it will exclude featured datasets. geozonestringOptionnel granularitystringOptionnel temporal_coveragestringOptionnel access_typestring · enumOptionnelValeurs possibles: openopen_with_accountrestricted organizationstringOptionnel badgestring · enumOptionnelValeurs possibles: pivotal-dataspdinspirehvdslsr organization_badgestring · enumOptionnelValeurs possibles: public-servicecertifiedassociationcompanylocal-authority ownerstringOptionnel followed_bystringOptionnel(beta, subject to change/be removed) formatstringOptionnel schemastringOptionnel schema_versionstringOptionnel topicstringOptionnel creditstringOptionnel dataservicestringOptionnel reusestringOptionnel archivedbooleanOptionnelIf set to true, it will filter on archived datasets only. If set to false, it will exclude archived datasets. User must be authenticated and results are limited to user visibility deletedbooleanOptionnelIf set to true, it will filter on deleted datasets only. If set to false, it will exclude deleted datasets. User must be authenticated and results are limited to user visibility privatebooleanOptionnelIf set to true, it will filter on private datasets only. If set to false, it will exclude private datasets. User must be authenticated and results are limited to user visibility Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json dataobject · Dataset (read)[]OptionnelThe page data Afficher propriétés next_pagestringOptionnelThe next page URL if exists pageinteger · min: 1RequisThe current page page_sizeintegerRequisThe page size used for pagination previous_pagestringOptionnelThe previous page URL if exists totalintegerRequisThe total paginated items get/datasets/ HTTP Copier GET /api/1/datasets/ HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier { "data": [ { "access_audiences": [ { "condition": "yes", "role": "local_authority_and_administration" } ], "access_type": "open", "access_type_reason": "text", "access_type_reason_category": "confidentiality_of_proceedings_of_public_authorities", "acronym": "text", "archived": "2026-01-01T00:00:00.000Z", "authorization_request_url": "text", "badges": [ { "kind": "text" } ], "contact_points": [ { "class": "text", "id": "text" } ], "created_at_internal": "2026-01-01T00:00:00.000Z", "deleted": "2026-01-01T00:00:00.000Z", "description": "text", "description_short": "text", "ext": {}, "extras": {}, "featured": true, "frequency": "continuous", "frequency_date": "2026-01-01T00:00:00.000Z", "harvest": {}, "id": "text", "last_modified_internal": "2026-01-01T00:00:00.000Z", "last_update": "2026-01-01T00:00:00.000Z", "license": "text", "metrics": {}, "organization": { "class": "text", "id": "text", "acronym": "text", "badges": [ { "kind": "text" } ], "logo": "text", "logo_thumbnail": "text", "name": "text", "page": "text", "permissions": { "delete": true, "edit": true, "harvest": true, "members": true, "private": true }, "slug": "text", "uri": "text" }, "owner": { "class": "text", "id": "text", "avatar": "text", "avatar_thumbnail": "text", "first_name": "text", "last_name": "text", "page": "text", "slug": "text", "uri": "text" }, "private": true, "quality_cached": {}, "resources": [ { "metrics": {} } ], "schema": {}, "slug": "text", "spatial": { "geom": { "coordinates": [ {} ], "type": "Point" }, "granularity": "other", "zones": {} }, "tags": [ "text" ], "temporal_coverage": { "end": "2026-01-01T00:00:00.000Z", "start": "2026-01-01T00:00:00.000Z" }, "title": "text" } ], "next_page": "text", "page": 1, "page_size": 1, "previous_page": "text", "total": 1 } Create a new dataset posthttp://www.data.gouv.fr/api/1/datasets/ Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Corps application/json access_audiencesobject · AccessAudience (read)[]Optionnel Afficher propriétés access_typestringOptionnel access_type_reasonstringOptionnel access_type_reason_categorystringOptionnel acronymstringOptionnelAn optional dataset acronym archivedstring · date-timeOptionnelThe archival date if archived authorization_request_urlstringOptionnel badgesobject · Badge (read)[]Lecture seuleOptionnelThe dataset badges Afficher propriétés community_resourcesobject · CommunityResourceOptionnel Afficher propriétés contact_pointsobject · ContactPoint (read)Optionnel Afficher propriétés created_atstring · date-timeLecture seuleRequisThis date is computed between harvested creation date if any and site's internal creation date deletedstring · date-timeLecture seuleOptionnelThe deletion date if deleted descriptionstring · markdownRequisThe dataset description in markdown description_shortstringOptionnelThe dataset short description extrasobjectOptionnelExtras attributes as key-value pairs featuredbooleanOptionnelIs the dataset featured frequencystring · enumRequisThe update frequency Default: unknownExample: continuousValeurs possibles: continuousoneMinutefiveMinutestenMinutesfifteenMinutesthirtyMinuteshourlybihourlytrihourlytwelveHoursseveralTimesADaythreeTimesADaysemidailydailyfiveTimesAWeekthreeTimesAWeeksemiweeklyweeklybiweeklythreeTimesAMonthsemimonthlymonthlybimonthlyquarterlythreeTimesAYearsemiannualannualbiennialtriennialquadrennialquinquennialdecennialbidecennialtridecennialpunctualirregularnevernotPlannedotherunknown frequency_datestring · date-timeOptionnelNext expected update date, you will be notified once that date is reached. harvestobject · HarvestDatasetMetadataOptionnel Afficher propriétés idstringLecture seuleOptionnelThe dataset identifier internalobject · DatasetInternalsOptionnel Afficher propriétés last_modifiedstring · date-timeLecture seuleRequisThe dataset last modification date last_updatestring · date-timeRequisThe resources last modification date licensestringOptionnelThe dataset license Default: notspecified metricsobjectOptionnelThe dataset metrics organizationobject · OrganizationReferenceOptionnel Afficher propriétés ownerobject · UserReferenceOptionnel Afficher propriétés pagestringLecture seuleOptionnelThe dataset web page URL permissionsobject · DatasetPermissionsOptionnel Afficher propriétés privatebooleanOptionnelIs the dataset private to the owner or the organization qualityobjectLecture seuleOptionnelThe dataset quality resourcesobject · ResourceOptionnel Afficher propriétés schemaobject · SchemaOptionnel Afficher propriétés slugstringLecture seuleOptionnelThe dataset permalink string spatialobject · SpatialCoverageOptionnel Afficher propriétés tagsstring[]Optionnel temporal_coverageobject · TemporalCoverageOptionnel Afficher propriétés titlestringRequisThe dataset title uristringLecture seuleOptionnelThe API URI for this dataset Réponses 201Success application/json access_audiencesobject · AccessAudience (read)[]Optionnel Afficher propriétés access_typestringOptionnel access_type_reasonstringOptionnel access_type_reason_categorystringOptionnel acronymstringOptionnelAn optional dataset acronym archivedstring · date-timeOptionnelThe archival date if archived authorization_request_urlstringOptionnel badgesobject · Badge (read)[]Lecture seuleOptionnelThe dataset badges Afficher propriétés community_resourcesobject · CommunityResourceOptionnel Afficher propriétés contact_pointsobject · ContactPoint (read)Optionnel Afficher propriétés created_atstring · date-timeLecture seuleRequisThis date is computed between harvested creation date if any and site's internal creation date deletedstring · date-timeLecture seuleOptionnelThe deletion date if deleted descriptionstring · markdownRequisThe dataset description in markdown description_shortstringOptionnelThe dataset short description extrasobjectOptionnelExtras attributes as key-value pairs featuredbooleanOptionnelIs the dataset featured frequencystring · enumRequisThe update frequency Default: unknownExample: continuousValeurs possibles: continuousoneMinutefiveMinutestenMinutesfifteenMinutesthirtyMinuteshourlybihourlytrihourlytwelveHoursseveralTimesADaythreeTimesADaysemidailydailyfiveTimesAWeekthreeTimesAWeeksemiweeklyweeklybiweeklythreeTimesAMonthsemimonthlymonthlybimonthlyquarterlythreeTimesAYearsemiannualannualbiennialtriennialquadrennialquinquennialdecennialbidecennialtridecennialpunctualirregularnevernotPlannedotherunknown frequency_datestring · date-timeOptionnelNext expected update date, you will be notified once that date is reached. harvestobject · HarvestDatasetMetadataOptionnel Afficher propriétés idstringLecture seuleOptionnelThe dataset identifier internalobject · DatasetInternalsOptionnel Afficher propriétés last_modifiedstring · date-timeLecture seuleRequisThe dataset last modification date last_updatestring · date-timeRequisThe resources last modification date licensestringOptionnelThe dataset license Default: notspecified metricsobjectOptionnelThe dataset metrics organizationobject · OrganizationReferenceOptionnel Afficher propriétés ownerobject · UserReferenceOptionnel Afficher propriétés pagestringLecture seuleOptionnelThe dataset web page URL permissionsobject · DatasetPermissionsOptionnel Afficher propriétés privatebooleanOptionnelIs the dataset private to the owner or the organization qualityobjectLecture seuleOptionnelThe dataset quality resourcesobject · ResourceOptionnel Afficher propriétés schemaobject · SchemaOptionnel Afficher propriétés slugstringLecture seuleOptionnelThe dataset permalink string spatialobject · SpatialCoverageOptionnel Afficher propriétés tagsstring[]Optionnel temporal_coverageobject · TemporalCoverageOptionnel Afficher propriétés titlestringRequisThe dataset title uristringLecture seuleOptionnelThe…