• Print

Information for developers

The technology architecture of the Government of Catalonia's open data service includes the organisation of the technological components that are involved in some part of the service, from the release of public data to its exploitation and reuse.

  1. Open Data Platform: The open data platform is the central architectural element, which uses Socrata technology. This platform, apart from operating as a data repository, offers a series of open data services that facilitate its use and reuse. The following are some of the options available on the open data platform: data query, multiple format downloads, creation of data filters and views, and the ability to access data via API REST.
  2. Data sources: The Public Administration receives, generates and manages a large amount of data, which is stored in a wide variety of information systems. The Administration is working on an ongoing basis to publish all the data it holds on the open data platform, provided there are no legal restrictions with regard to its publication.
  3. Open Data Portal: The open data portal provides access to the catalogue and data via the Internet. It currently includes both datasets uploaded on the Socrata platform and datasets which can be accessed via links to other Government of Catalonia websites.
  4. Data views: Both the public administration and the citizens and other external users may use the data available on the open data platform as an information source to create interactive data views, maps, search engines and apps that are updated in real time.

The objective of the Catalonia open data portal data catalogue is to act as a reference catalogue for the location of open data sources. Many of this data is stored and available on the Catalonia open data portal itself but additional links to other more specific websites are also provided. Some of the websites that exist alongside the Catalonia open data portal are

The Government of Catalonia open data platform uses Socrata technology, which enables API use. Socrata's own website features a wide range of articles, guides and resources aimed at both experienced and novice developers. The website can be accessed by clicking here: https://dev.socrata.com/.

The reuse of information generated by the public sector as a concept refers to its potential use by individuals, companies and organisations in the development of new products and/or services for other audiences and recipients.

The terms of use for the datasets published on the Open Data Portal are subject to the corresponding current regulations: Law 37/2007, on the reuse of public sector information, as amended by Law 18/2015 (transposing Directive 2013/37/EU), and Law 29/2010 on the use of electronic media in the public sector in Catalonia, which regulate the release of public data and the conditions for reuse. Similarly, Law 19/2014 on transparency, access to public information and good governance, establishes that public information may be reused with any legitimate objective, particularly with regard to the reproduction and disclosure by any means of the data subject to public information and the creation of added value information products and services based on said data.

The use of datasets published on the Open Data Portal implies the acceptance of these terms of use.


Types of reuse of the Government of Catalonia Open Data Portal


In accordance with the recommendations of the Science and Technology Avanza Plan Guía de reutilización del Proyecto Aporta (Aporta Project Guide to Reuse), there are four types of reuse of information under specific terms of use:


  • General. No restrictions beyond the basic terms established in article 8 of Law 37/2007, amended by Law 18/2015. This type applies by default to all datasets except those for which a different type is indicated. See ‘General terms of use and licences’.
  • Data considered works (with intellectual property rights) is made available to third parties by means of Creative Commons licences, the most open dissemination licences, which enable both the commercial exploitation and creation of derived works.
  • In certain cases, such as photographs taken by third parties, the licence to reuse is the Creative Commons – Attribution-NoDerivs (BY-ND) licence, that is, it allows the commercial use of the work but not the generation of derivative works.
  • Finally, there is a type of reuse upon prior request according to the terms established by the generating entity, whose details will be provided to agree on specific terms of use.


General terms of use and licenses


These general terms of use enable the reuse of documents and data subject to them for commercial and non-commercial purposes.

The reuse of data and documents on the Government of Catalonia Open Data Portal is subject to the following general terms:

  • That the content of the information, including the metadata, is not altered.
  • That the meaning of the information is not distorted.
  • That the source is cited.
  • That the date of the last update is cited.
  • When the information contains personal data, the specific purpose or purposes for which the data may be reused in the future must be specified.
  • When the information, even if it is provided in a dissociated manner, contains sufficient elements to allow the identification of the interested parties during the reuse process, the dissociation procedure may not be reversed through the addition of new data from other sources.

These terms shall apply generally to all datasets on the Open Data Portal, except those for which a different type of licence is indicated.


Source citation formulas


The Government of Catalonia recommends the following source citation formula for the reuse of datasets by companies or users:

Source: Government of Catalonia. [name of the organisation or autonomous body]

If this credit is being added in HTML format, the following format, or similar, can be used:

Source of data: Government of Catalonia.

The Secretariat for Transparency and Open Government, as the relevant competent body, is responsible for leading and coordinating projects related to the integration and release of public data, providing functional support with regard to the publication strategy for open data and promotion of its use and exploitation and dealing with the operative management of the open data portal. The department can be contacted via the following contact form.

Collaborative use of public information can lead to increased transparency and greater control with regard to public activity, to the promotion of democratic innovation and the creation of services and applications that have a positive impact on society. With that in mind, the actions of those people interested in the reuse of public data are a key factor, which is why ...

...we encourage you to:

  • Use the datasets as a primary data source, so that the data in your data views or applications is automatically updated. The datasets on the open data platform are updated periodically (daily or over longer periods, depending on each case); therefore, if your applications refer directly to a dataset on the platform, you will not have to perform any action to update the information in your application.
  • Cite the source and authorship of the datasets that you elect to use for your data views or applications.
  • Specifically indicate, where possible, which data is taken from official sources, which data comes from other sources and which data comes from calculations carried out within or external to your application.
  • Contact us in the event that you identify any error or incorrect or inconsistent information in the data you are consulting, and send us suggestions with your ideas on how to improve the service.
  • Let us know of any datasets you would like to see published on the open data platform and evaluate and comment on those already published which you have found useful.

...we advise against:

  • Claiming that your application is an official government service.
  • Presenting data in a deceptive or incorrect manner or falsifying the data.
  • Using this site for ideological purposes or those associated with political parties, the open data portal is an initiative funded with public money, therefore it is inappropriate to politicise its service.
  • Making use of open public data to support racist, sexist or homophobic theories or those that promote or incite discrimination or violence.
  • Making use of open public data to support criminal or illegal activity.