posts

Posts related operations

List all posts

GET//www.data.gouv.fr/api/1/posts/
Query parameters
Header parameters
Response

Success

Body
dataarray of Post (object)

The page data

next_pagestring

The next page URL if exists

page*integer

The current page

page_size*integer

The page size used for pagination

previous_pagestring

The previous page URL if exists

total*integer

The total paginated items

Request
const response = await fetch('//www.data.gouv.fr/api/1/posts/', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "data": [
    {
      "body_type": "markdown",
      "content": "text",
      "created_at": "2024-12-09T19:32:06.993Z",
      "credit_to": "text",
      "credit_url": "text",
      "datasets": [
        {
          "acronym": "text",
          "archived": "2024-12-09T19:32:06.993Z",
          "badges": [
            {
              "kind": "text"
            }
          ],
          "community_resources": [
            {
              "checksum": {
                "type": "sha1",
                "value": "text"
              },
              "created_at": "2024-12-09T19:32:06.993Z",
              "description": "text",
              "filesize": 0,
              "filetype": "file",
              "format": "text",
              "harvest": {
                "created_at": "2024-12-09T19:32:06.993Z",
                "modified_at": "2024-12-09T19:32:06.993Z",
                "uri": "text"
              },
              "id": "text",
              "internal": {
                "created_at_internal": "2024-12-09T19:32:06.993Z",
                "last_modified_internal": "2024-12-09T19:32:06.993Z"
              },
              "last_modified": "2024-12-09T19:32:06.993Z",
              "latest": "text",
              "mime": "text",
              "preview_url": "text",
              "schema": {
                "name": "text",
                "url": "text",
                "version": "text"
              },
              "title": "text",
              "type": "main",
              "url": "text",
              "dataset": {
                "class": "text",
                "id": "text",
                "acronym": "text",
                "page": "text",
                "title": "text",
                "uri": "text"
              },
              "organization": {
                "class": "text",
                "id": "text",
                "acronym": "text",
                "badges": [
                  {
                    "kind": "text"
                  }
                ],
                "logo": "text",
                "logo_thumbnail": "text",
                "name": "text",
                "page": "text",
                "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"
              }
            }
          ],
          "contact_point": {
            "contact_form": "text",
            "email": "text",
            "id": "text",
            "name": "text",
            "organization": {
              "class": "text",
              "id": "text",
              "acronym": "text",
              "badges": [
                {
                  "kind": "text"
                }
              ],
              "logo": "text",
              "logo_thumbnail": "text",
              "name": "text",
              "page": "text",
              "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"
            }
          },
          "created_at": "2024-12-09T19:32:06.993Z",
          "deleted": "2024-12-09T19:32:06.993Z",
          "description": "text",
          "featured": false,
          "frequency": "unknown",
          "frequency_date": "2024-12-09T19:32:06.993Z",
          "harvest": {
            "archived": "text",
            "archived_at": "2024-12-09T19:32:06.993Z",
            "backend": "text",
            "ckan_name": "text",
            "ckan_source": "text",
            "created_at": "2024-12-09T19:32:06.993Z",
            "dct_identifier": "text",
            "domain": "text",
            "last_update": "2024-12-09T19:32:06.993Z",
            "modified_at": "2024-12-09T19:32:06.993Z",
            "remote_id": "text",
            "remote_url": "text",
            "source_id": "text",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2024-12-09T19:32:06.993Z",
            "last_modified_internal": "2024-12-09T19:32:06.993Z"
          },
          "last_modified": "2024-12-09T19:32:06.993Z",
          "last_update": "2024-12-09T19:32:06.993Z",
          "license": "notspecified",
          "organization": {
            "class": "text",
            "id": "text",
            "acronym": "text",
            "badges": [
              {
                "kind": "text"
              }
            ],
            "logo": "text",
            "logo_thumbnail": "text",
            "name": "text",
            "page": "text",
            "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"
          },
          "page": "text",
          "private": false,
          "resources": [
            {
              "checksum": {
                "type": "sha1",
                "value": "text"
              },
              "created_at": "2024-12-09T19:32:06.993Z",
              "description": "text",
              "filesize": 0,
              "filetype": "file",
              "format": "text",
              "harvest": {
                "created_at": "2024-12-09T19:32:06.993Z",
                "modified_at": "2024-12-09T19:32:06.993Z",
                "uri": "text"
              },
              "id": "text",
              "internal": {
                "created_at_internal": "2024-12-09T19:32:06.993Z",
                "last_modified_internal": "2024-12-09T19:32:06.993Z"
              },
              "last_modified": "2024-12-09T19:32:06.993Z",
              "latest": "text",
              "mime": "text",
              "preview_url": "text",
              "schema": {
                "name": "text",
                "url": "text",
                "version": "text"
              },
              "title": "text",
              "type": "main",
              "url": "text"
            }
          ],
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "slug": "text",
          "spatial": {
            "geom": {
              "coordinates": [],
              "type": "Point"
            },
            "granularity": "other",
            "zones": [
              "text"
            ]
          },
          "tags": [
            "text"
          ],
          "temporal_coverage": {
            "end": "2024-12-09T19:32:06.993Z",
            "start": "2024-12-09T19:32:06.993Z"
          },
          "title": "text",
          "uri": "text"
        }
      ],
      "headline": "text",
      "id": "text",
      "image": "text",
      "last_modified": "2024-12-09T19:32:06.993Z",
      "name": "text",
      "owner": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "page": "text",
      "published": "2024-12-09T19:32:06.993Z",
      "reuses": [
        {
          "archived": "2024-12-09T19:32:06.993Z",
          "badges": [
            {
              "kind": "text"
            }
          ],
          "created_at": "2024-12-09T19:32:06.993Z",
          "datasets": [
            {
              "acronym": "text",
              "archived": "2024-12-09T19:32:06.993Z",
              "badges": [
                {
                  "kind": "text"
                }
              ],
              "community_resources": [
                {
                  "checksum": {
                    "type": "sha1",
                    "value": "text"
                  },
                  "created_at": "2024-12-09T19:32:06.993Z",
                  "description": "text",
                  "filesize": 0,
                  "filetype": "file",
                  "format": "text",
                  "harvest": {
                    "created_at": "2024-12-09T19:32:06.993Z",
                    "modified_at": "2024-12-09T19:32:06.993Z",
                    "uri": "text"
                  },
                  "id": "text",
                  "internal": {
                    "created_at_internal": "2024-12-09T19:32:06.993Z",
                    "last_modified_internal": "2024-12-09T19:32:06.993Z"
                  },
                  "last_modified": "2024-12-09T19:32:06.993Z",
                  "latest": "text",
                  "mime": "text",
                  "preview_url": "text",
                  "schema": {
                    "name": "text",
                    "url": "text",
                    "version": "text"
                  },
                  "title": "text",
                  "type": "main",
                  "url": "text",
                  "dataset": {
                    "class": "text",
                    "id": "text",
                    "acronym": "text",
                    "page": "text",
                    "title": "text",
                    "uri": "text"
                  },
                  "organization": {
                    "class": "text",
                    "id": "text",
                    "acronym": "text",
                    "badges": [
                      {
                        "kind": "text"
                      }
                    ],
                    "logo": "text",
                    "logo_thumbnail": "text",
                    "name": "text",
                    "page": "text",
                    "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"
                  }
                }
              ],
              "contact_point": {
                "contact_form": "text",
                "email": "text",
                "id": "text",
                "name": "text",
                "organization": {
                  "class": "text",
                  "id": "text",
                  "acronym": "text",
                  "badges": [
                    {
                      "kind": "text"
                    }
                  ],
                  "logo": "text",
                  "logo_thumbnail": "text",
                  "name": "text",
                  "page": "text",
                  "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"
                }
              },
              "created_at": "2024-12-09T19:32:06.993Z",
              "deleted": "2024-12-09T19:32:06.993Z",
              "description": "text",
              "featured": false,
              "frequency": "unknown",
              "frequency_date": "2024-12-09T19:32:06.993Z",
              "harvest": {
                "archived": "text",
                "archived_at": "2024-12-09T19:32:06.993Z",
                "backend": "text",
                "ckan_name": "text",
                "ckan_source": "text",
                "created_at": "2024-12-09T19:32:06.993Z",
                "dct_identifier": "text",
                "domain": "text",
                "last_update": "2024-12-09T19:32:06.993Z",
                "modified_at": "2024-12-09T19:32:06.993Z",
                "remote_id": "text",
                "remote_url": "text",
                "source_id": "text",
                "uri": "text"
              },
              "id": "text",
              "internal": {
                "created_at_internal": "2024-12-09T19:32:06.993Z",
                "last_modified_internal": "2024-12-09T19:32:06.993Z"
              },
              "last_modified": "2024-12-09T19:32:06.993Z",
              "last_update": "2024-12-09T19:32:06.993Z",
              "license": "notspecified",
              "organization": {
                "class": "text",
                "id": "text",
                "acronym": "text",
                "badges": [
                  {
                    "kind": "text"
                  }
                ],
                "logo": "text",
                "logo_thumbnail": "text",
                "name": "text",
                "page": "text",
                "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"
              },
              "page": "text",
              "private": false,
              "resources": [
                {
                  "checksum": {
                    "type": "sha1",
                    "value": "text"
                  },
                  "created_at": "2024-12-09T19:32:06.993Z",
                  "description": "text",
                  "filesize": 0,
                  "filetype": "file",
                  "format": "text",
                  "harvest": {
                    "created_at": "2024-12-09T19:32:06.993Z",
                    "modified_at": "2024-12-09T19:32:06.993Z",
                    "uri": "text"
                  },
                  "id": "text",
                  "internal": {
                    "created_at_internal": "2024-12-09T19:32:06.993Z",
                    "last_modified_internal": "2024-12-09T19:32:06.993Z"
                  },
                  "last_modified": "2024-12-09T19:32:06.993Z",
                  "latest": "text",
                  "mime": "text",
                  "preview_url": "text",
                  "schema": {
                    "name": "text",
                    "url": "text",
                    "version": "text"
                  },
                  "title": "text",
                  "type": "main",
                  "url": "text"
                }
              ],
              "schema": {
                "name": "text",
                "url": "text",
                "version": "text"
              },
              "slug": "text",
              "spatial": {
                "geom": {
                  "coordinates": [],
                  "type": "Point"
                },
                "granularity": "other",
                "zones": [
                  "text"
                ]
              },
              "tags": [
                "text"
              ],
              "temporal_coverage": {
                "end": "2024-12-09T19:32:06.993Z",
                "start": "2024-12-09T19:32:06.993Z"
              },
              "title": "text",
              "uri": "text"
            }
          ],
          "deleted": "2024-12-09T19:32:06.993Z",
          "description": "text",
          "featured": false,
          "id": "text",
          "image": "text",
          "image_thumbnail": "text",
          "last_modified": "2024-12-09T19:32:06.993Z",
          "organization": {
            "class": "text",
            "id": "text",
            "acronym": "text",
            "badges": [
              {
                "kind": "text"
              }
            ],
            "logo": "text",
            "logo_thumbnail": "text",
            "name": "text",
            "page": "text",
            "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"
          },
          "page": "text",
          "private": false,
          "slug": "text",
          "tags": [
            "text"
          ],
          "title": "text",
          "topic": "health",
          "type": "api",
          "uri": "text",
          "url": "text"
        }
      ],
      "slug": "text",
      "tags": [
        "text"
      ],
      "uri": "text"
    }
  ],
  "next_page": "text",
  "page": 0,
  "page_size": 0,
  "previous_page": "text",
  "total": 0
}

Create a post

POST//www.data.gouv.fr/api/1/posts/
Header parameters
Body
body_typestring

HTML or markdown body type

content*string (markdown)

The post content in Markdown

created_atstring (date-time)

The post creation date

credit_tostring

An optional credit line (associated to the image)

credit_urlstring

An optional link associated to the credits

datasetsarray of Dataset (object)

The post datasets

headline*string

The post headline

idstring

The post identifier

imagestring

The post image

last_modifiedstring (date-time)

The post last modification date

name*string

The post name

ownerall of

The owner user

pagestring

The post page URL

publishedstring (date-time)

The post publication date

reusesarray of Reuse_read_ (object)

The post reuses

slugstring

The post permalink string

tagsarray of string

Some keywords to help in search

uristring

The post API URI

Response

Success

Body
body_typestring

HTML or markdown body type

content*string (markdown)

The post content in Markdown

created_atstring (date-time)

The post creation date

credit_tostring

An optional credit line (associated to the image)

credit_urlstring

An optional link associated to the credits

datasetsarray of Dataset (object)

The post datasets

headline*string

The post headline

idstring

The post identifier

imagestring

The post image

last_modifiedstring (date-time)

The post last modification date

name*string

The post name

ownerall of

The owner user

pagestring

The post page URL

publishedstring (date-time)

The post publication date

reusesarray of Reuse_read_ (object)

The post reuses

slugstring

The post permalink string

tagsarray of string

Some keywords to help in search

uristring

The post API URI

Request
const response = await fetch('//www.data.gouv.fr/api/1/posts/', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "content": "text",
      "headline": "text",
      "name": "text"
    }),
});
const data = await response.json();
Response
{
  "body_type": "markdown",
  "content": "text",
  "created_at": "2024-12-09T19:32:06.993Z",
  "credit_to": "text",
  "credit_url": "text",
  "datasets": [
    {
      "acronym": "text",
      "archived": "2024-12-09T19:32:06.993Z",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2024-12-09T19:32:06.993Z",
          "description": "text",
          "filesize": 0,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "created_at": "2024-12-09T19:32:06.993Z",
            "modified_at": "2024-12-09T19:32:06.993Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2024-12-09T19:32:06.993Z",
            "last_modified_internal": "2024-12-09T19:32:06.993Z"
          },
          "last_modified": "2024-12-09T19:32:06.993Z",
          "latest": "text",
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text",
          "dataset": {
            "class": "text",
            "id": "text",
            "acronym": "text",
            "page": "text",
            "title": "text",
            "uri": "text"
          },
          "organization": {
            "class": "text",
            "id": "text",
            "acronym": "text",
            "badges": [
              {
                "kind": "text"
              }
            ],
            "logo": "text",
            "logo_thumbnail": "text",
            "name": "text",
            "page": "text",
            "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"
          }
        }
      ],
      "contact_point": {
        "contact_form": "text",
        "email": "text",
        "id": "text",
        "name": "text",
        "organization": {
          "class": "text",
          "id": "text",
          "acronym": "text",
          "badges": [
            {
              "kind": "text"
            }
          ],
          "logo": "text",
          "logo_thumbnail": "text",
          "name": "text",
          "page": "text",
          "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"
        }
      },
      "created_at": "2024-12-09T19:32:06.993Z",
      "deleted": "2024-12-09T19:32:06.993Z",
      "description": "text",
      "featured": false,
      "frequency": "unknown",
      "frequency_date": "2024-12-09T19:32:06.993Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2024-12-09T19:32:06.993Z",
        "backend": "text",
        "ckan_name": "text",
        "ckan_source": "text",
        "created_at": "2024-12-09T19:32:06.993Z",
        "dct_identifier": "text",
        "domain": "text",
        "last_update": "2024-12-09T19:32:06.993Z",
        "modified_at": "2024-12-09T19:32:06.993Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2024-12-09T19:32:06.993Z",
        "last_modified_internal": "2024-12-09T19:32:06.993Z"
      },
      "last_modified": "2024-12-09T19:32:06.993Z",
      "last_update": "2024-12-09T19:32:06.993Z",
      "license": "notspecified",
      "organization": {
        "class": "text",
        "id": "text",
        "acronym": "text",
        "badges": [
          {
            "kind": "text"
          }
        ],
        "logo": "text",
        "logo_thumbnail": "text",
        "name": "text",
        "page": "text",
        "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"
      },
      "page": "text",
      "private": false,
      "resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2024-12-09T19:32:06.993Z",
          "description": "text",
          "filesize": 0,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "created_at": "2024-12-09T19:32:06.993Z",
            "modified_at": "2024-12-09T19:32:06.993Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2024-12-09T19:32:06.993Z",
            "last_modified_internal": "2024-12-09T19:32:06.993Z"
          },
          "last_modified": "2024-12-09T19:32:06.993Z",
          "latest": "text",
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text"
        }
      ],
      "schema": {
        "name": "text",
        "url": "text",
        "version": "text"
      },
      "slug": "text",
      "spatial": {
        "geom": {
          "coordinates": [],
          "type": "Point"
        },
        "granularity": "other",
        "zones": [