# dados.gov.pt Datasets API

**Canonical:** https://apis.io/apis/open-government-portugal/open-government-portugal-datasets-api/  
**Provider:** dados.gov.pt — https://apis.io/providers/open-government-portugal/  
**Base URL:** https://dados.gov.pt/api/1  
**Documentation:** https://dados.gov.pt/pt/recursos/desenvolvimento/referencia-api

dados.gov.pt Datasets API is one of 23 APIs that [dados.gov.pt](https://apis.io/providers/open-government-portugal/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Datasets. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 6 JSON Schemas.

Dataset related operations

## Operations (50)

| Method | Path | Summary |
|---|---|---|
| GET | `/datasets/` | List or search all datasets |
| POST | `/datasets/` | Create a new dataset |
| GET | `/datasets/badges/` | List all available dataset badges and their labels |
| GET | `/datasets/community_resources/` | List all community resources |
| POST | `/datasets/community_resources/` | Create a new community resource |
| DELETE | `/datasets/community_resources/{community}/` | Delete a given community resource |
| GET | `/datasets/community_resources/{community}/` | Retrieve a community resource given its identifier |
| PUT | `/datasets/community_resources/{community}/` | Update a given community resource |
| POST | `/datasets/community_resources/{community}/upload/` | Update the file related to a given community resource |
| GET | `/datasets/extensions/` | List all allowed resources extensions |
| GET | `/datasets/frequencies/` | List all available frequencies |
| GET | `/datasets/licenses/` | List all available licenses |
| GET | `/datasets/proxy/download/` | Fetch an external resource server-side and stream it back with |
| GET | `/datasets/r/{id}` | Stream the latest version of a resource as a forced download |
| GET | `/datasets/recent.atom` | Recent datasets atom feed |
| GET | `/datasets/resource_types/` | List all resource types |
| GET | `/datasets/schemas/` | List all available schemas |
| GET | `/datasets/suggest/` | Datasets suggest endpoint using mongoDB contains |
| GET | `/datasets/suggest/formats/` | Suggest file formats |
| GET | `/datasets/suggest/mime/` | Suggest mime types |
| DELETE | `/datasets/{dataset}/` | Delete a dataset given its identifier |
| GET | `/datasets/{dataset}/` | Get a dataset given its identifier |
| PUT | `/datasets/{dataset}/` | Update a dataset given its identifier |
| POST | `/datasets/{dataset}/badges/` | Create a new badge for a given dataset |
| DELETE | `/datasets/{dataset}/badges/{badge_kind}/` | Delete a badge for a given dataset |
| DELETE | `/datasets/{dataset}/featured/` | Unmark the dataset as featured |
| POST | `/datasets/{dataset}/featured/` | Mark the dataset as featured |
| GET | `/datasets/{dataset}/rdf` | Rdf dataset |
| GET | `/datasets/{dataset}/rdf.{_format}` | Rdf dataset format |
| POST | `/datasets/{dataset}/resources/` | Create a new resource for a given dataset |
| PUT | `/datasets/{dataset}/resources/` | Reorder resources |
| GET | `/datasets/{dataset}/resources/` | Get the given dataset resources, paginated |
| DELETE | `/datasets/{dataset}/resources/{rid}/` | Delete a given resource on a given dataset |
| GET | `/datasets/{dataset}/resources/{rid}/` | Get a resource given its identifier |
| PUT | `/datasets/{dataset}/resources/{rid}/` | Update a given resource on a given dataset |
| POST | `/datasets/{dataset}/resources/{rid}/upload/` | Upload a file related to a given resource on a given dataset |
| POST | `/datasets/{dataset}/upload/` | Upload a file for a new dataset resource |
| POST | `/datasets/{dataset}/upload/community/` | Upload a new community resource |
| DELETE | `/datasets/{id}/followers/` | Unfollow an object given its ID |
| GET | `/datasets/{id}/followers/` | List all followers for a given object |
| POST | `/datasets/{id}/followers/` | Follow an object given its ID |
| GET | `/datasets/resources/{rid}/` | Get resource |
| GET | `/datasets/search/` | List or search all datasets |
| DELETE | `/datasets/{dataset}/extras/` | Delete a given dataset extras key on a given dataset |
| GET | `/datasets/{dataset}/extras/` | Get a dataset extras given its identifier |
| PUT | `/datasets/{dataset}/extras/` | Update a given dataset extras |
| DELETE | `/datasets/{dataset}/resources/{rid}/extras/` | Delete a given resource extras key on a given dataset |
| GET | `/datasets/{dataset}/resources/{rid}/extras/` | Get a resource extras given its identifier |
| PUT | `/datasets/{dataset}/resources/{rid}/extras/` | Update a given resource extras on a given dataset |
| GET | `/datasets/{dataset}/schemas/` | Get a dataset schemas given its identifier |

## Machine-readable artifacts (9)

- **OpenAPI** — https://artifacts.apis.io/open-government-portugal/openapi/open-government-portugal-datasets-api-openapi.yml
- **Documentation** — https://dados.gov.pt/pt/recursos/desenvolvimento/referencia-api
- **APIReference** — https://dados.gov.pt/api/1/
- **JSONSchema** — https://artifacts.apis.io/open-government-portugal/json-schema/open-government-portugal-dataset-schema.json
- **JSONSchema** — https://artifacts.apis.io/open-government-portugal/json-schema/open-government-portugal-resource-schema.json
- **JSONSchema** — https://artifacts.apis.io/open-government-portugal/json-schema/open-government-portugal-catalog-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/open-government-portugal/json-schema/open-government-portugal-dataset-search-page-schema.json
- **JSONSchema** — https://artifacts.apis.io/open-government-portugal/json-schema/open-government-portugal-license-schema.json
- **JSONSchema** — https://artifacts.apis.io/open-government-portugal/json-schema/open-government-portugal-community-resource-page-schema.json

## Other dados.gov.pt APIs (12)

- [dados.gov.pt Access Type API](https://apis.io/apis/open-government-portugal/open-government-portugal-access-type-api/)
- [dados.gov.pt Captchetat API](https://apis.io/apis/open-government-portugal/open-government-portugal-captchetat-api/)
- [dados.gov.pt Contacts API](https://apis.io/apis/open-government-portugal/open-government-portugal-contacts-api/)
- [dados.gov.pt Dataservices API](https://apis.io/apis/open-government-portugal/open-government-portugal-dataservices-api/)
- [dados.gov.pt Discussions API](https://apis.io/apis/open-government-portugal/open-government-portugal-discussions-api/)
- [dados.gov.pt Harvest API](https://apis.io/apis/open-government-portugal/open-government-portugal-harvest-api/)
- [dados.gov.pt Me API](https://apis.io/apis/open-government-portugal/open-government-portugal-me-api/)
- [dados.gov.pt Notifications API](https://apis.io/apis/open-government-portugal/open-government-portugal-notifications-api/)
- [dados.gov.pt Organizations API](https://apis.io/apis/open-government-portugal/open-government-portugal-organizations-api/)
- [dados.gov.pt Pages API](https://apis.io/apis/open-government-portugal/open-government-portugal-pages-api/)
- [dados.gov.pt Posts API](https://apis.io/apis/open-government-portugal/open-government-portugal-posts-api/)
- [dados.gov.pt Proconnect API](https://apis.io/apis/open-government-portugal/open-government-portugal-proconnect-api/)

## Tags

Datasets

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/open-government-portugal/open-government-portugal-datasets-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/open-government-portugal/.
