Web Service Method: Request the Trend History of Concepts

Abstract

Description
Requests the trend history of multiple concepts

URL: /GraphSearch/api/trend/histories

Request

Supported Methods
GET

HTTP Parameters

Parameter	Comment	Type	Required
searchSpaceId	ID of the search space	String	true
concepts	Comma separated list of URIs of requested concepts	List of URIs	true

Response

This method returns execution results in JSON format.

Array of ConceptTrend

Attribute	Type	Comment
concept	Concept	Trend concept
trend	Array of longs	Trend values

Example of Response Attribute ConceptTrend

{
  "trend" : [ { }, { } ],
  "concept" : {
    "score" : 5709,
    "topConcepts" : [ "https://semantic-web.com/api/topConcepts#1760", "https://semantic-web.com/api/topConcepts#5789" ],
    "inScheme" : [ "some inScheme" ],
    "label" : "some label",
    "transitiveBroaders" : [ "some transitiveBroaders", "some transitiveBroaders", "some transitiveBroaders" ],
    "uri" : "https://semantic-web.com/api/uri#22455"
  }
}

Concept

Attribute	Type	Comment
prefLabel	String	PrefLabel
uri	String	Uri
score	Integer	Score
inScheme	Array of Strings	InSchemes
topConcepts	Array of Strings	TopConcepts
transitiveBroaders	Array of Strings	TransitiveBroaders

Example of Response Attribute Concept

{
  "score" : 22951,
  "topConcepts" : [ "https://semantic-web.com/api/topConcepts#16171" ],
  "inScheme" : [ "some inScheme" ],
  "label" : "some label",
  "transitiveBroaders" : [ "some transitiveBroaders" ],
  "uri" : "https://semantic-web.com/api/uri#31171"
}

Note

The return to this request will display these errors in the following specific cases:

If the Search Space ID is wrong, you will receive a 404 'Bad Request' message, with specific information in a JSON message as to the value that was not found.
If the credentials were mistyped or wrong: a 403 Forbidden, and a JSON message 'Access denied' will be returned.
If you didn't specify a Search Space ID: the return will be made for the default Search Space.
- If the default Search Space is private and you are not authenticated, you will also receive a 403 Forbidden in a JSON message.

In this section: