This site is part of

Multilingual Thesaurus of the European Union

EuroVoc Web service

getConceptURIbyTermAndLang

Search a term (Preferred or Non Preferred Term) in EuroVoc and return the URIs of the corresponding concept(s) or concept (s) matching the found term(s).

Sample call with all parameters 

http://eurovoc.europa.eu/webservices/getConceptURIbyTermAndLang?term=accident&termType=prefLabel&searchMode=exact&format=TXT&lang=en

(Parameters indicated in red are mandatory)

Definition of the Web service Parameters

Parameters

 

Description

Examples

term

[mandatory] 

The search string to search for. (case insensitive)

term=accident

term=help for victims combined with searchMode=exact

 

termType

[optional]

The type of term to look for; by default, searches both PTs (Preferred Terms or prefLabel) and NPTs (Non Preferred Terms or altLabel);

If set, value can be "prefLabel" or "altLabel".

termType=prefLabel

termType=altLabel

searchMode

[mandatory] 

Defines the type of search to perform. The following value can be used: "contains", "exact", "startsWith" or "endsWith".

searchMode=contains

searchMode=exact

searchMode=startsWith

searchMode= endsWith

format

[mandatory]

Defines the format of the service response. The value can be "RDF" or "TXT".

format=RDF

format=TXT

lang

[optional]

Defines the language of EuroVoc in which the search should be performed.

If no value has been provided, all languages are searched;

If set, the search is performed in the specified language.

lang=bg

lang=es

lang=cs

lang=da

lang=en

Language values are based on the ISO 639-2 language codes.

Examples

1. Get the URI of the concept that contains the exact prefLabel "help for victims" in English. The URI is provided in TXT format.

http://eurovoc.europa.eu/webservices/getConceptURIbyTermAndLang?term=help for victims&termType=prefLabel&searchMode=exact&format=TXT&lang=en

2. Get a list of URIs for concepts that contain the term "accident" either in their prefLabel or altLabel, in any languages. The list of URIs is saved in a RDF file.

http://eurovoc.europa.eu/webservices/getConceptURIbyTermAndLang?term=accident&searchMode=contains&format=RDF

 

getLabelsByConceptURI

Search an concept URI in EuroVoc and return the corresponding labels (Preferred Terms or Non Preferred Terms) matching the found URI.

Sample call with all

http://eurovoc.europa.eu/webservices/getLabelsByConceptURI?URI=http://eurovoc.europa.eu/1321&termType=prefLabel&lang=en&format=txt

(Parameters indicated in red are mandatory)

Definition of the Web service Parameters

Parameters

 

Description

Examples

URI 

[mandatory] 

The URI to search for

URI=http://eurovoc.europa.eu/1321 

termType 

[mandatory] 

The type of term to look for; by default, searches both PTs (Preferred Terms or prefLabel) and NPTs (Non Preferred Terms or altLabel);

If set, value can be "prefLabel" or "altLabel".

termType=prefLabel

termType=altLabel

format 

[mandatory]

Defines the format of the service response. The value can be "RDF" or "TXT".

format=RDF

format=TXT

lang

[optional]

Defines the language in which the labels should be displayed;

If no value has been provided, all languages are displayed by default;

If set, the labels are displayed in the specified language.

lang=bg

lang=es

lang=cs

lang=da

lang=en

Language values are based on the ISO 639-2 language codes.

Examples

 1. Get the Preferred Terms (prefLabel) of the concept URI "http://eurovoc.europa.eu/1321". The labels are provided in TXT format in all the languages.

http://eurovoc.europa.eu/webservices/getLabelsByConceptURI?URI=http://eurovoc.europa.eu/1321&termType=prefLabel&format=txt

2. Get the Non Preferred Terms (altLabel) of the concept URI "http://eurovoc.europa.eu/1321" . The labels are provided in TXT format and in all the languages.

http://eurovoc.europa.eu/webservices/getLabelsByConceptURI?URI=http://eurovoc.europa.eu/1321&termType=altLabel&format=txt

3. Get the Non Preferred Terms (altLabel) of the concept URI "http://eurovoc.europa.eu/1321" in a selected language (Danish). The labels are provided in TXT format.

http://eurovoc.europa.eu/webservices/getLabelsByConceptURI?URI=http://eurovoc.europa.eu/1321&termType=altLabel&lang=da&format=txt

4. Get the Preferred Terms (prefLabel) of the concept URI "http://eurovoc.europa.eu/1321" in all the languages. The labels are provided in RDF format.

http://eurovoc.europa.eu/webservices/getLabelsByConceptURI?URI=http://eurovoc.europa.eu/1321&termType=prefLabel&&format=rdf

 

getAlignmentsByConceptURI 

Search an concept URI in EuroVoc and return the corresponding mappings (skos:exactMatch, skos:closeMatch, skos:broadMatch or skos:narrowMatch) matching the found URI.

Sample call 

http://eurovoc.europa.eu/webservices/getAlignmentsByConceptURI?URI=http://eurovoc.europa.eu/965&targetScheme=unbis&mappingType=exactMatch&format=rdf

(Parameters indicated in red are mandatory)

Definition of the Web service Parameters

Parameters

 

Description

Examples

URI 

[mandatory] 

The URI to search for.

URI=http://eurovoc.europa.eu/965

targetScheme 

[optional] 

If specified, provides results for the specified target thesaurus, otherwise for all targeted thesauri.

◦Supported values: agrovoc, eclas, gemet, inspire, or unbis.

targetScheme=unbis

mappingType 

[optional]

If specified, provides results for the indicated relationship or type of mapping, otherwise for all mapping relationships.

Supported values: broadMatch, closeMatch, exactMatch, narrowMatch, relatedMatch

mappingType=exactMatch

mappingType=closeMatch

mappingType=broadMatch

mappingType=NarrowMatch

mappingType=relatedMatch 

format 

[mandatory]

Defines the format of the service response.

Supported values: TXT or RDF

format=RDF

format=TXT

nt

[optional]

If set, it retrieves the alignments for the narrower concepts (NT) of the requested Concept URI.

nt

Examples

 1. Get the mappings of the concept URI http://eurovoc.europa.eu/965. The mappings are provided in TXT format.

http://eurovoc.europa.eu/webservices/getAlignmentsByConceptURI?URI=http://eurovoc.europa.eu/965&format=txt

 2. Get the mappings of the concept URI http://eurovoc.europa.eu/965. The mappings are provided in RDF format.

 http://eurovoc.europa.eu/webservices/getAlignmentsByConceptURI?URI=http://eurovoc.europa.eu/965&format=rdf

 3. Get the mappings of the narrower concept (NT) of the selected concept URI http://eurovoc.europa.eu/965. The mappings are provided in TXT format.

 http://eurovoc.europa.eu/webservices/getAlignmentsByConceptURI?URI=http://eurovoc.europa.eu/965&format=txt&nt

 4. Get the "relatedMatch" mappings of the concept URI http://eurovoc.europa.eu/965. The mappings are provided in TXT format.

 http://eurovoc.europa.eu/webservices/getAlignmentsByConceptURI?URI=http://eurovoc.europa.eu/965&mappingType=relatedMatch&format=txt

 5. Get the mappings of the EuroVoc concept URI http://eurovoc.europa.eu/965 to Unbis, the United Nations Thesauri. The mappings are provided in TXT format.

  http://eurovoc.europa.eu/webservices/getAlignmentsByConceptURI?URI=http://eurovoc.europa.eu/965&targetScheme=unbis&format=txt

 

getRelatedTermsByConceptURI 

Search a concept URI in EuroVoc and return the corresponding Related Terms (RT).

Sample call

http://eurovoc.europa.eu/webservices/getRelatedTermsByConceptURI?URI=http://eurovoc.europa.eu/1321&format=txt

(Parameters indicated in red are mandatory)

Definition of the Web service Parameters

Parameters

 

Description

Examples

URI 

[mandatory] 

The URI to search for.

URI=http://eurovoc.europa.eu/965

format 

[mandatory]

Defines the format of the service response.

Supported values: TXT or RDF

format=RDF

format=TXT

nt

[optional]

If set, it retrieves the alignments for the narrower concepts (NT) of the requested Concept URI.

nt

Examples

1. Get the Related Terms (RT) of the concept URI http://eurovoc.europa.eu/1321.The results are provided in TXT format.

http://eurovoc.europa.eu/webservices/getRelatedTermsByConceptURI?URI=http://eurovoc.europa.eu/1321&format=txt

2. Get the Related Terms (RT) of the concept URI http://eurovoc.europa.eu/1321.The results are provided in RDF format.

http://eurovoc.europa.eu/webservices/getRelatedTermsByConceptURI?URI=http://eurovoc.europa.eu/1321&format=rdf

3. Get the Related Terms (RT) for the narrower concepts (NT) of the selected concept URI http://eurovoc.europa.eu/1321. The results are provided in TXT format.

 http://eurovoc.europa.eu/webservices/getRelatedTermsByConceptURI?URI=http://eurovoc.europa.eu/1321&format=txt&nt

Using the web service

The web service can be called by a Web application or Web page using either a HTTP, where the parameters are specified in the query string, or a XML/RPC protocol.