Skip to main content
POST
/
api
/
euopendata
/
datasets
/
search
/euopendata/datasets/search
curl --request POST \
  --url https://api.anysite.io/api/euopendata/datasets/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "q": "population",
  "country": [
    "it",
    "fr"
  ],
  "categories": [
    "ENER",
    "ENVI"
  ],
  "format": [
    "CSV",
    "JSON"
  ],
  "keywords": [
    "statistics"
  ],
  "catalog": [
    "data-gov-ie"
  ],
  "super_catalog": [
    "european-union-open-data-portal"
  ],
  "publisher": [
    "Instituto Nacional de Estadística"
  ],
  "subject": [
    "5907"
  ],
  "hvd_category": [
    "c_e1da4e07"
  ],
  "in_series": [
    "<string>"
  ],
  "license": [
    "CC_BY_4_0"
  ],
  "scoring": [],
  "is_hvd": true,
  "sort": "relevance"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "@type": "@euopendata_dataset",
    "title": "<string>",
    "description": "<string>",
    "landing_page": "<string>",
    "country": "<string>",
    "is_hvd": false,
    "access_right": "<string>",
    "accrual_periodicity": "<string>",
    "scoring": 123,
    "issued": "<string>",
    "modified": "<string>",
    "temporal_start": "<string>",
    "temporal_end": "<string>",
    "spatial": [],
    "languages": [],
    "keywords": [],
    "categories": [],
    "publisher": {
      "@type": "@euopendata_agent",
      "name": "<string>",
      "type": "<string>",
      "email": "<string>",
      "homepage": "<string>",
      "resource": "<string>"
    },
    "creators": [],
    "contact_points": [],
    "catalog": {
      "@type": "@euopendata_catalog",
      "id": "<string>",
      "title": "<string>",
      "description": "<string>",
      "country": "<string>",
      "homepage": "<string>",
      "source_type": "<string>",
      "publisher": {
        "@type": "@euopendata_agent",
        "name": "<string>",
        "type": "<string>",
        "email": "<string>",
        "homepage": "<string>",
        "resource": "<string>"
      }
    },
    "distributions": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Max result count

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
q
string | null

Search keyword

Example:

"population"

country
string[] | null

Filter by publishing country (ISO 3166-1 alpha-2)

Example:
["it", "fr"]
categories
enum<string>[] | null

Filter by DCAT data theme

Available options:
AGRI,
GOVE,
ECON,
ENVI,
JUST,
REGI,
TECH,
SOCI,
TRAN,
EDUC,
HEAL,
ENER,
INTR,
OP_DATPRO
Example:
["ENER", "ENVI"]
format
string[] | null

Filter by distribution file format

Example:
["CSV", "JSON"]
keywords
string[] | null

Filter by dataset keyword/tag

Example:
["statistics"]
catalog
string[] | null

Filter by source catalog id

Example:
["data-gov-ie"]
super_catalog
string[] | null

Filter by aggregating super-catalog id

Example:
["european-union-open-data-portal"]
publisher
string[] | null

Filter by publishing organisation name

Example:
["Instituto Nacional de Estadística"]
subject
string[] | null

Filter by EuroVoc subject id

Example:
["5907"]
hvd_category
string[] | null

Filter by High-Value-Dataset category id

Example:
["c_e1da4e07"]
in_series
string[] | null

Filter by parent dataset-series id

license
string[] | null

Filter by distribution license id

Example:
["CC_BY_4_0"]
scoring
enum<string>[] | null

Filter by metadata quality score band

Available options:
excellentScoring,
goodScoring,
sufficientScoring,
badScoring
data_scope
enum<string> | null

Filter by geographic data scope

Available options:
eu,
io,
countryData
source_type
enum<string> | null

Filter by catalog source type

Available options:
dcat-ap,
geospatial,
ckan,
jsonapi,
udata,
euodp-legacy,
inspire,
socrata
is_hvd
boolean | null

Filter to High-Value Datasets only

sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
recent,
name

Response

Successful Response

id
string
required
url
string
required
@type
string
default:@euopendata_dataset
title
string | null
description
string | null
landing_page
string | null
country
string | null
is_hvd
boolean
default:false
access_right
string | null
accrual_periodicity
string | null
scoring
integer | null
issued
string | null
modified
string | null
temporal_start
string | null
temporal_end
string | null
spatial
Spatial · object[]
languages
string[]
keywords
EuopendataKeyword · object[]
categories
EuopendataCategoryRef · object[]
publisher
EuopendataAgent · object
creators
EuopendataAgent · object[]
contact_points
EuopendataContactPoint · object[]
catalog
EuopendataCatalog · object
distributions
EuopendataDistribution · object[]