--- title: "List all posts" method: GET path: "/posts/" tags: ["posts"] --- # List all posts `GET /posts/` ## Request - Base URL: `https://dados.gov.pt/api/1` - URL: `https://dados.gov.pt/api/1/posts/` - Auth: none declared ## Query parameters - `page` integer - `page_size` integer - `sort` 'created_at' | 'modified' | 'created' | 'last_modified' | 'name' | 'headline' | 'published' | '-created_at' | '-modified' | '-created' | '-last_modified' | '-name' | '-headline' | '-published' - `q` string - `kind` 'news' | 'page' - `with_drafts` boolean ## Headers - `X-Fields` string, mask ## Response `200` Success - PostPage - `data` PostRead[]: The page data - `body_type` 'markdown' | 'html' | 'blocs' - `content` string, markdown - `content_as_page` PageRead - `blocs` object[] - `created_at` string, date-time, required - `id` string, required - `last_modified` string, date-time, required - `organization` OrganizationReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `acronym` string: The organization acronym - `badges` BadgeRead[]: The organization badges - `kind` string, required - `logo` string: The organization logo URL - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version. - `name` string: The organization name - `page` string: The organization web page URL - `permissions` OrganizationPermissions - `delete` boolean - `edit` boolean - `harvest` boolean - `members` boolean - `private` boolean - `slug` string: The organization string used as permalink - `uri` string: The API URI for this organization - `owner` UserReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `avatar` string: The user avatar URL - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version. - `first_name` string: The user first name - `last_name` string: The user larst name - `page` string: The user web page URL - `slug` string: The user permalink string - `uri` string: The API URI for this user - `permissions` PagePermissions - `delete` boolean - `edit` boolean - `created_at` string, date-time, required - `credit_to` string: An optional credit line (associated to the image) - `credit_url` string: An optional link associated to the credits - `datasets` Dataset[]: The post datasets - `access_audiences` AccessAudienceRead[] - `condition` 'yes' | 'no' | 'under_condition' - `role` 'local_authority_and_administration' | 'company_and_association' | 'private' - `access_type` string - `access_type_reason` string - `access_type_reason_category` string - `acronym` string: An optional dataset acronym - `archived` string, date-time: The archival date if archived - `authorization_request_url` string - `badges` BadgeRead[]: The dataset badges - `kind` string, required - `community_resources` CommunityResource[] - `checksum` Checksum - `type` 'sha1' | 'sha2' | 'sha256' | 'md5' | 'crc': The hashing algorithm used to compute the checksum - `value` string, required: The resulting checksum/hash - `created_at` string, date-time: The resource creation date - `description` string, markdown: The resource markdown description - `extras` object: Extra attributes as key-value pairs - `filesize` integer: The resource file size in bytes - `filetype` 'file' | 'remote', required: Whether the resource is an uploaded file, a remote file or an API - `format` string, required: The resource format - `harvest` HarvestResourceMetadata - `issued_at` string, date-time: The resource harvested release date - `modified_at` string, date-time: The resource harvest last modification date - `uri` string: The resource harvest uri - `id` string: The resource unique ID - `internal` ResourceInternals - `created_at_internal` string, date-time, required: The resource's internal creation date on the site - `last_modified_internal` string, date-time, required: The resource's internal last modification date - `last_modified` string, date-time: The resource last modification date - `latest` string: The permanent URL redirecting to the latest version of the resource. When the resource data is updated, the URL will change, the latest URL won't. - `metrics` object: The resource metrics - `mime` string: The resource mime type - `preview_url` string: An optional preview URL to be loaded as a standalone page (ie. iframe or new page) - `schema` Schema - `name` string - `url` string - `version` string - `title` string, required: The resource title - `type` 'main' | 'documentation' | 'update' | 'api' | 'code' | 'other', required: Resource type (documentation, API...) - `url` string, required: The resource URL - `dataset` DatasetReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `organization` OrganizationReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `acronym` string: The organization acronym - `badges` BadgeRead[]: The organization badges - `kind` string, required - `logo` string: The organization logo URL - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version. - `name` string: The organization name - `page` string: The organization web page URL - `permissions` OrganizationPermissions - `delete` boolean - `edit` boolean - `harvest` boolean - `members` boolean - `private` boolean - `slug` string: The organization string used as permalink - `uri` string: The API URI for this organization - `owner` UserReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `avatar` string: The user avatar URL - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version. - `first_name` string: The user first name - `last_name` string: The user larst name - `page` string: The user web page URL - `slug` string: The user permalink string - `uri` string: The API URI for this user - `permissions` DatasetPermissions - `delete` boolean - `edit` boolean - `edit_resources` boolean - `contact_points` ContactPointRead[] - `contact_form` string - `email` string - `id` string, required - `name` string, required - `organization` OrganizationReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `acronym` string: The organization acronym - `badges` BadgeRead[]: The organization badges - `kind` string, required - `logo` string: The organization logo URL - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version. - `name` string: The organization name - `page` string: The organization web page URL - `permissions` OrganizationPermissions - `delete` boolean - `edit` boolean - `harvest` boolean - `members` boolean - `private` boolean - `slug` string: The organization string used as permalink - `uri` string: The API URI for this organization - `owner` UserReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `avatar` string: The user avatar URL - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version. - `first_name` string: The user first name - `last_name` string: The user larst name - `page` string: The user web page URL - `slug` string: The user permalink string - `uri` string: The API URI for this user - `role` 'contact' | 'creator' | 'publisher' | 'rightsHolder' | 'custodian' | 'distributor' | 'originator' | 'principalInvestigator' | 'processor' | 'resourceProvider' | 'user', required - `created_at` string, date-time, required: This date is computed between harvested creation date if any and site's internal creation date - `deleted` string, date-time: The deletion date if deleted - `description` string, markdown, required: The dataset description in markdown - `description_short` string: The dataset short description - `extras` object: Extras attributes as key-value pairs - `featured` boolean: Is the dataset featured - `frequency` 'continuous' | 'oneMinute' | 'fiveMinutes' | 'tenMinutes' | 'fifteenMinutes' | 'thirtyMinutes' | 'hourly' | 'bihourly' | 'trihourly' | 'twelveHours' | 'severalTimesADay' | 'threeTimesADay' | 'semidaily' | 'daily' | 'fiveTimesAWeek' | 'threeTimesAWeek' | 'semiweekly' | 'weekly' | 'biweekly' | 'threeTimesAMonth' | 'semimonthly' | 'monthly' | 'bimonthly' | 'quarterly' | 'threeTimesAYear' | 'semiannual' | 'annual' | 'biennial' | 'triennial' | 'quadrennial' | 'quinquennial' | 'decennial' | 'bidecennial' | 'tridecennial' | 'punctual' | 'irregular' | 'never' | 'notPlanned' | 'other' | 'unknown', required: The update frequency - `frequency_date` string, date-time: Next expected update date, you will be notified once that date is reached. - `harvest` HarvestDatasetMetadata - `archived` string: The reason the dataset has been archived - `archived_at` string, date-time: The archive date - `backend` string: Harvest backend used - `created_at` string, date-time: The dataset harvested creation date - `dct_identifier` string: The dct:identifier property from the harvested dataset - `domain` string: The harvested domain - `issued_at` string, date-time: The dataset harvested release date - `last_update` string, date-time: The last harvest date - `modified_at` string, date-time: The dataset harvest last modification date - `remote_id` string: The dataset remote id on the source portal - `remote_url` string: The dataset remote url - `source_id` string: The harvester id - `uri` string: The dataset harveted uri - `id` string: The dataset identifier - `internal` DatasetInternals - `created_at_internal` string, date-time, required: The dataset's internal creation date on the site - `last_modified_internal` string, date-time, required: The dataset's internal last modification date - `last_modified` string, date-time, required: The dataset last modification date - `last_update` string, date-time, required: The resources last modification date - `license` string: The dataset license - `license_title` string: The dataset license human-readable title - `license_url` string: The dataset license URL - `metrics` object: The dataset metrics - `organization` OrganizationReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `acronym` string: The organization acronym - `badges` BadgeRead[]: The organization badges - `kind` string, required - `logo` string: The organization logo URL - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version. - `name` string: The organization name - `page` string: The organization web page URL - `permissions` OrganizationPermissions - `delete` boolean - `edit` boolean - `harvest` boolean - `members` boolean - `private` boolean - `slug` string: The organization string used as permalink - `uri` string: The API URI for this organization - `owner` UserReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `avatar` string: The user avatar URL - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version. - `first_name` string: The user first name - `last_name` string: The user larst name - `page` string: The user web page URL - `slug` string: The user permalink string - `uri` string: The API URI for this user - `page` string: The dataset web page URL - `permissions` DatasetPermissions - `delete` boolean - `edit` boolean - `edit_resources` boolean - `private` boolean: Is the dataset private to the owner or the organization - `quality` object: The dataset quality - `resources` Resource[] - `checksum` Checksum - `type` 'sha1' | 'sha2' | 'sha256' | 'md5' | 'crc': The hashing algorithm used to compute the checksum - `value` string, required: The resulting checksum/hash - `created_at` string, date-time: The resource creation date - `description` string, markdown: The resource markdown description - `extras` object: Extra attributes as key-value pairs - `filesize` integer: The resource file size in bytes - `filetype` 'file' | 'remote', required: Whether the resource is an uploaded file, a remote file or an API - `format` string, required: The resource format - `harvest` HarvestResourceMetadata - `issued_at` string, date-time: The resource harvested release date - `modified_at` string, date-time: The resource harvest last modification date - `uri` string: The resource harvest uri - `id` string: The resource unique ID - `internal` ResourceInternals - `created_at_internal` string, date-time, required: The resource's internal creation date on the site - `last_modified_internal` string, date-time, required: The resource's internal last modification date - `last_modified` string, date-time: The resource last modification date - `latest` string: The permanent URL redirecting to the latest version of the resource. When the resource data is updated, the URL will change, the latest URL won't. - `metrics` object: The resource metrics - `mime` string: The resource mime type - `preview_url` string: An optional preview URL to be loaded as a standalone page (ie. iframe or new page) - `schema` Schema - `name` string - `url` string - `version` string - `title` string, required: The resource title - `type` 'main' | 'documentation' | 'update' | 'api' | 'code' | 'other', required: Resource type (documentation, API...) - `url` string, required: The resource URL - `schema` Schema - `name` string - `url` string - `version` string - `slug` string: The dataset permalink string - `spatial` SpatialCoverage - `geom` GeoJSON - `coordinates` object[], required: The geometry as coordinates lists - `type` 'Point' | 'LineString' | 'Polygon' | 'MultiPoint' | 'MultiLineString' | 'MultiPolygon', required: The GeoJSON Type - `granularity` object: The spatial/territorial granularity (full Granularity object if `X-Get-Datasets-Full-Objects` is set, ID of the granularity otherwise) - `zones` object: The covered zones identifiers (full GeoZone objects if `X-Get-Datasets-Full-Objects` is set, IDs of the zones otherwise) - `tags` string[] - `temporal_coverage` TemporalCoverage - `end` string, date-time: The temporal coverage end date - `start` string, date-time, required: The temporal coverage start date - `title` string, required: The dataset title - `uri` string: The API URI for this dataset - `headline` string - `id` string, required - `image` string: URL of the image - `image_thumbnail` string: URL of the cropped and squared image (100x100) - `image_url` string - `kind` 'news' | 'page': Post kind (news or page) - `last_modified` string, date-time, required - `name` string, required - `owner` UserReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `avatar` string: The user avatar URL - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version. - `first_name` string: The user first name - `last_name` string: The user larst name - `page` string: The user web page URL - `slug` string: The user permalink string - `uri` string: The API URI for this user - `page` string: The post web page URL - `published` string, date-time: The post publication date - `reuses` ReuseReference[]: The post reuses - `class` string, required: The object class - `id` string, required: The object unique identifier - `image` string: URL of the image - `image_thumbnail` string: URL of the cropped and squared image (500x500) - `page` string: Link to the udata web page for this reuse - `title` string, required - `uri` string: Link to the API endpoint for this reuse - `slug` string, required - `tags` string[]: Some keywords to help in search - `uri` string: The API URI for this post - `next_page` string: The next page URL if exists - `page` integer, required: The current page - `page_size` integer, required: The page size used for pagination - `previous_page` string: The previous page URL if exists - `total` integer, required: The total paginated items ## Changes - **2026-09-11** `1175d034be00`: 1 info - added the new optional `query` request parameter `kind` - **2025-03-14** `c9488618431d`: 1 info - added the new optional `query` request parameter `q` - **2025-02-18** `8a6c4a5665e6`: 1 info - added the new optional `query` request parameter `with_drafts` [Operation history](https://skmtc.dev/dados/apis/udata-api/changes/posts/get.md) --- [API](https://skmtc.dev/dados/apis/udata-api.md) - [All operations](https://skmtc.dev/dados/apis/udata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dados/apis/udata-api/revisions/77edaf8a00ea?raw)