extracts parameter
- Last Updated: May 13, 2026
- 1 minute read
- Semaphore
- Documentation
While making any REST request of the concepts server, you can restrict the amount of data coming back by using the extracts parameter. By default, all the data associated with the returned concepts is returned. However, you can use the extracts parameter to list the data that you actually want returned. For example
This is a list of all the concept in the selected model. The output can be reduced by selecting only the required data. For example:
http://<<Base URL>>/models/SpaceMissions/concepts?extracts=id,prefLabels[./lang="en"],prefLabels[./lang=""]
which returns the concept id as well as the preferred labels that are present in English or language neutral
[{
"id" : "a2789037-9966-4475-8f76-69a773ec20e2",
"prefLabels" : [ {
"propertyUri" : "http://www.w3.org/2008/05/skos-xl#prefLabel",
"value" : "Jean-Loup Chrétien",
"lang" : "en"
} ]
}]
Extracting particular label types
It is possible to return all alternative labels of a particular type using an extracts parameter of the form
altLabels[./propertyUri="http%3A%2F%2Fmodels.smartlogic.com%2FSpaceMissions%23cosparId"]
This the value in the quotation marks is the URL encoded form of the URI of the label type,
So
http://<<Base URL>>/models/SpaceMissions/concepts?limit=10&extracts=id,altLabels[./propertyUri=%22http%3A%2F%2Fmodels.smartlogic.com%2FSpaceMissions%23cosparId%22]
Extracting particular metadata types
To return a particular metadata type from concepts, you can use the URL
http://<<Base URL>>/models/SpaceMissions/concepts/2370e81c-29b4-4e2e-ad8d-37f3d20d3b4b?limit=10&extracts=id,metadata[./propertyUri="http%3A%2F%2Fmodels.smartlogic.com%2FSpaceMissions%23DBPedia-URI"]