# France Open Data API

> data.gouv.fr: 75,000+ French public datasets, searchable, with row queries on CSV resources

- Vendor: `franceopendataapi` · version 1.0 · category Government Data · tags data gouv fr api, data gouv fr open data api, udata api, government open data api, open datasets api, public data catalog api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/franceopendataapi
- This document: https://apiclay.com/docs/franceopendataapi.md
- OpenAPI 3.1: https://apiclay.com/api/franceopendataapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `franceopendataapi`
- Updated: 2026-11-18

## About

## France Open Data API

The national open data portal of France (www.data.gouv.fr, run on udata): about 75,585 datasets, for example the register of first names given since 1900. Search datasets by keyword, organisation or tag, read any dataset with its resources and download links, and list the publishing organisations, plus row-by-row reads of CSV resources through the tabular API.

Data comes from **data.gouv.fr** (https://www.data.gouv.fr). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/datasets?q=&amp;page_size=5`, then `/dataset?id=` for its resources and `/rows?resource_id=&amp;page_size=20`.

### Routes

#### GET `/datasets` - Datasets
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | no | Keyword search. |
| organization | query | string | no | Organisation `id` from `/organizations`. |
| tag | query | string | no | Tag. |
| sort | query | string | no | e.g. `-created` or `-last_update`. |
| page | query | number | no | Page, from 1. |
| page_size | query | number | no | Datasets per page (up to 100). |

Returns: `total` and `data`: datasets with `id`, `slug`, `title`, `description`, `organization`, `tags`, `license`, `last_update` and `resources` (`id`, `title`, `format`, `url`).

#### GET `/dataset` - Dataset
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Dataset `id` or `slug` from `/datasets`. |

Returns: one dataset with all its `resources` and download URLs.

#### GET `/organizations` - Organizations
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | no | Name search. |
| page | query | number | no | Page, from 1. |
| page_size | query | number | no | Organisations per page. |

Returns: `total` and `data`: publishing organisations with `id`, `name`, `slug` and metrics.

#### GET `/rows` - Rows
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| resource_id | path | string | yes | A CSV resource `id` from `/dataset`. |
| page | query | number | no | Page, from 1. |
| page_size | query | number | no | Rows per page (up to 200). |

Returns: `data` (rows keyed by column), `links` (`next`, `profile`) and `meta.total`.

### Caveats

- Text is in the portal's language.
- Some datasets name individuals (licence holders, employees, drivers, arrestees) as published by the government; handle them under applicable privacy law.
- Each dataset carries its own licence (`license`); credit France.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by data.gouv.fr.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /datasets — Datasets
- Gateway: `GET https://api.apiclay.com/v1/api/franceopendataapi/datasets`
- Public query params: `q` (string), `organization` (string), `tag` (string), `sort` (string), `page` (number), `page_size` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /dataset — Dataset
- Gateway: `GET https://api.apiclay.com/v1/api/franceopendataapi/dataset`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /organizations — Organizations
- Gateway: `GET https://api.apiclay.com/v1/api/franceopendataapi/organizations`
- Public query params: `q` (string), `page` (number), `page_size` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /rows — Rows
- Gateway: `GET https://api.apiclay.com/v1/api/franceopendataapi/rows`
- Public query params: `page` (number), `page_size` (number), `resource_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/franceopendataapi/datasets" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
