EU Open Data Portal

EU Open Data Portal Global API

The Global API from EU Open Data Portal — 2 operation(s) for global.

GitHub OpenAPI

Operations 2

GET /global Get global metrics #
GET /global/history Get historic global metrics #

Documentation

📖
APIReference
https://data.europa.eu/api/hub/search/
📖
Documentation
https://dataeuropa.gitlab.io/data-provider-manual/api-documentation/
📖
APIReference
https://data.europa.eu/api/hub/repo/
📖
APIReference
https://data.europa.eu/api/mqa/cache/
📖
APIReference
https://data.europa.eu/api/mqa/shacl/
📖
APIReference
https://data.europa.eu/api/mqa/reporter/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/eu-open-data-portal/refs/heads/main/openapi/eu-open-data-portal-global-api-openapi.yml

Other Resources

🔗
SourceCode
https://gitlab.com/dataeuropa/hub/search
🔗
Examples
https://gitlab.com/dataeuropa/api-usage-examples
🔗
SourceCode
https://gitlab.com/dataeuropa/hub/repo
🔗
ChangeLog
https://gitlab.com/dataeuropa/hub/repo/-/blob/main/CHANGELOG.md
🔗
SourceCode
https://gitlab.com/dataeuropa/mqa/cache
🔗
SourceCode
https://gitlab.com/dataeuropa/mqa/validating-shacl
🔗
SourceCode
https://gitlab.com/dataeuropa/mqa/reporter

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/eu-open-data-portal-global-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

eu-open-data-portal-global-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 5.8.3
  title: Metrics Cache Global API
  description: The API is designed to provide actual quality information for datasets.
  x-logo:
    url: images/logo
servers:
- url: ''
tags:
- name: Global
paths:
  /global:
    get:
      tags:
      - Global
      summary: Get global metrics
      description: To get a general overview in terms of data quality for all available metadata, make a GET request to the specified URL of the API endpoint with the resource path "/global" added at the end of the URL. If successful, the response will contain metrics that cover the dimensions of 'findability', 'accessibility', 'interoperability', 'reusability', and 'contextuality'.
      operationId: getGlobalMetrics
      parameters:
      - $ref: '#/components/parameters/filterGlobal'
      responses:
        200:
          description: Metrics regarding all available catalogues
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  result:
                    type: object
                    properties:
                      count:
                        type: integer
                      results:
                        type: array
                        items:
                          $ref: '#/components/schemas/Metrics'
  /global/history:
    get:
      summary: Get historic global metrics
      description: To retrieve the history of measurements for all available metadata that are accessible on the portal make GET request to the specified URL of the API endpoint with the resource path "/global/history" added at the end of the URL. Include the "startDate" query parameter in the request, providing a valid date value in the correct format. This specifies the start date for retrieving the measurement history. If successful, the response will contain metrics that covers the dimensions 'findability', 'accessibility', 'interoperability', 'reusability' and 'contextuality'.
      operationId: getHistoricGlobalMetrics
      parameters:
      - $ref: '#/components/parameters/filterGlobal'
      - $ref: '#/components/parameters/startDate'
      - $ref: '#/components/parameters/endDate'
      - $ref: '#/components/parameters/resolution'
      tags:
      - Global
      responses:
        200:
          description: Metrics regarding all available catalogues
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  result:
                    type: object
                    properties:
                      count:
                        type: integer
                      results:
                        type: array
                        items:
                          $ref: '#/components/schemas/HistoricMetrics'
        400:
          description: Bad Request (e.g. startDate is later then endDate).
components:
  parameters:
    endDate:
      name: endDate
      in: query
      description: End date for which to retrieve the history. If no end date is specified, the currend date is used.
      schema:
        type: string
        format: date
      example: 2012-11-1
    filterGlobal:
      name: filter
      in: query
      description: Filter for one more multiple specific dimensions and/or the `score` that should be returned. If present,  the document will contain _only_ the specified Dimensions. If this parameter is missing, the complete document will be returned.
      required: false
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
          enum:
          - findability
          - accessibility
          - interoperability
          - reusability
          - contextuality
          - score
    startDate:
      name: startDate
      in: query
      description: Start date for which to retrieve the history formatted as ISO
      required: true
      schema:
        type: string
        format: date
      example: 1997-8-25
    resolution:
      name: resolution
      in: query
      description: Dimension for which to retrieve the history
      required: false
      schema:
        enum:
        - year
        - month
        - day
        default: month
  schemas:
    HistoricReusability:
      description: Reusability metrics
      type: object
      properties:
        licenceAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        licenceAlignment:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        accessRightsAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        accessRightsAlignment:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        contactPointAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        publisherAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        score:
          $ref: '#/components/schemas/HistoricScore'
    Metrics:
      description: A full page of metrics related to the entity with the specified ID
      type: object
      properties:
        findability:
          $ref: '#/components/schemas/Findability'
        accessibility:
          $ref: '#/components/schemas/Accessibility'
        interoperability:
          $ref: '#/components/schemas/Interoperability'
        resusability:
          $ref: '#/components/schemas/Reusability'
        contextuality:
          $ref: '#/components/schemas/Contextuality'
        score:
          description: The aggregated score
          type: number
          format: int32
          example: 300
    HistoricMetrics:
      description: A full page of metrics related to the entity with the specified ID
      type: object
      properties:
        findability:
          $ref: '#/components/schemas/HistoricFindability'
        accessibility:
          $ref: '#/components/schemas/HistoricAccessibility'
        interoperability:
          $ref: '#/components/schemas/HistoricInteroperability'
        resusability:
          $ref: '#/components/schemas/HistoricReusability'
        contextuality:
          $ref: '#/components/schemas/HistoricContextuality'
        score:
          $ref: '#/components/schemas/HistoricScore'
    HistoricFindability:
      description: Findability metrics
      type: object
      properties:
        keywordAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        categoryAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        spatialAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        temporalAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        score:
          $ref: '#/components/schemas/HistoricScore'
    Contextuality:
      description: Contextuality metrics
      type: object
      properties:
        rightsAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        byteSizeAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        dateIssuedAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        dateModifiedAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        score:
          description: The aggregated score
          type: object
          items:
            $ref: '#/components/schemas/PointPercentageMax'
          example:
            point: 55.0
            percentage: 55.0
            max: 80.0
    Accessibility:
      description: Accessibility metrics
      type: object
      properties:
        accessUrlStatusCodes:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: 200
            percentage: 92.0
          - name: 400
            percentage: 1.0
          - name: 404
            percentage: 1.0
          - name: 1300
            percentage: 2.0
          - name: 405
            percentage: 3.0
          - name: 1100
            percentage: 1.0
        downloadUrlAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        downloadUrlStatusCodes:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
        score:
          description: The aggregated score
          type: object
          items:
            $ref: '#/components/schemas/PointPercentageMax'
          example:
            point: 55.0
            percentage: 55.0
            max: 80.0
    HistoricContextuality:
      description: Contextuality metrics
      type: object
      properties:
        rightsAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        byteSizeAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        dateIssuedAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        dateModifiedAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        score:
          $ref: '#/components/schemas/HistoricScore'
    HistoricAccessibility:
      description: Accessibility metrics
      type: object
      properties:
        accessUrlStatusCodes:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: 200
              percentage: 55.0
            - name: 404
              percentage: 45.0
          - '2020-03-03':
            - name: 200
              percentage: 33.0
            - name: 404
              percentage: 67.0
          - '2020-03-04':
            - name: 200
              percentage: 82.5
            - name: 500
              percentage: 17.5
        downloadUrlAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        downloadUrlStatusCodes:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: 200
              percentage: 55.0
            - name: 404
              percentage: 45.0
          - '2020-03-03':
            - name: 404
              percentage: 33.0
            - name: 500
              percentage: 67.0
          - '2020-03-04':
            - name: 200
              percentage: 82.5
            - name: 500
              percentage: 17.5
        score:
          $ref: '#/components/schemas/HistoricScore'
    PointPercentageMax:
      description: Point Percentage Max
      type: object
      properties:
        point:
          type: number
          format: double
          example: 50.5
        percentage:
          type: number
          format: double
          example: 50.5
        max:
          type: number
          format: double
          example: 80.0
    Reusability:
      description: Reusability metrics
      type: object
      properties:
        licenceAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        licenceAlignment:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        accessRightsAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        accessRightsAlignment:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        contactPointAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        publisherAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        score:
          description: The aggregated score
          type: object
          items:
            $ref: '#/components/schemas/PointPercentageMax'
          example:
            point: 55.0
            percentage: 55.0
            max: 80.0
    HistoricScore:
      description: List of name value pairs, where key is the date and value is the score.
      type: object
      properties:
        score:
          type: array
          items:
            type: object
            additionalProperties:
              type: integer
      example:
      - '2020-03-02': 200.0
      - '2020-03-03': 221.0
      - '2020-03-04': 221.0
    HistoricNamedPercentages:
      description: A history of named percentages.
      type: object
      additionalProperties:
        $ref: '#/components/schemas/NamedPercentage'
      minProperties: 1
    Interoperability:
      description: Interoperability metrics
      type: object
      properties:
        formatAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        mediaTypeAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        formatMediaTypeAlignment:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        formatMediaTypeNonProprietary:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        formatMediaTypeMachineReadable:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        dcatApCompliance:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        score:
          description: The aggregated score
          type: object
          items:
            $ref: '#/components/schemas/PointPercentageMax'
          example:
            point: 55.0
            percentage: 55.0
            max: 80.0
    HistoricInteroperability:
      description: Interoperability metrics
      type: object
      properties:
        formatAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        mediaTypeAvailability:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        formatMediaTypeAlignment:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        formatMediaTypeNonProprietary:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        formatMediaTypeMachineReadable:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        dcatApCompliance:
          type: array
          items:
            $ref: '#/components/schemas/HistoricNamedPercentages'
          example:
          - '2020-03-02':
            - name: true
              percentage: 55.0
            - name: false
              percentage: 45.0
          - '2020-03-03':
            - name: true
              percentage: 33.0
            - name: false
              percentage: 67.0
          - '2020-03-04':
            - name: true
              percentage: 82.5
            - name: false
              percentage: 17.5
        score:
          $ref: '#/components/schemas/HistoricScore'
    NamedPercentage:
      description: Named percentage
      type: object
      properties:
        name:
          type: string
          example: true
        percentage:
          type: number
          format: double
          example: 50.5
    Findability:
      description: Findability metrics
      type: object
      properties:
        keywordAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        categoryAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        spatialAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        temporalAvailability:
          type: array
          items:
            $ref: '#/components/schemas/NamedPercentage'
          example:
          - name: true
            percentage: 55.0
          - name: false
            percentage: 45.0
        score:
          description: The aggregated score
          type: object
          items:
            $ref: '#/components/schemas/PointPercentageMax'
          example:
            point: 55.0
            percentage: 55.0
            max: 80.0
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT